Available Tools

The Hype Doc MCP server exposes the following tools. MCP clients call these automatically based on your natural language requests.

log_win

Log a new win/achievement.

Parameters

Parameter	Type	Required	Description
body	string	Yes	The win content. Supports plain text, HTML, or markdown.
body_format	string	No	"plain", "html", or "markdown" (default: "markdown")
space_name	string	Yes	Name of the space (e.g. “Work”, “Personal”)
occurred_on	string	No	Date in YYYY-MM-DD format (defaults to today)
tag_names	string[]	No	Tags to apply to the win

Response

{
  "id": 42,
  "body_html": "<p>Shipped the new API</p>",
  "body_text": "Shipped the new API",
  "space": "Work",
  "occurred_on": "2026-03-01",
  "tags": ["launch"]
}

Notes

• Space names are matched case-insensitively
• If the space doesn’t exist, the error lists available spaces
• Returns a 402 equivalent if you’ve hit the free plan limit

---

list_wins

List wins, optionally filtered by space, date range, tags, or search query.

Parameters

Parameter	Type	Required	Description
space_name	string	No	Filter by space name
since	string	No	Only wins on or after this date (YYYY-MM-DD)
until	string	No	Only wins on or before this date (YYYY-MM-DD)
tag	string	No	Filter by tag name
q	string	No	Search query to filter wins by content
limit	integer	No	Max results (default: 20, max: 100)

Response

{
  "wins": [
    {
      "id": 42,
      "body_html": "<p>Shipped the new API</p>",
      "body_text": "Shipped the new API",
      "space": "Work",
      "occurred_on": "2026-03-01",
      "tags": ["launch"]
    }
  ],
  "count": 1
}

---

create_space

Create a new space (category) for organizing wins. Use list_spaces first to check existing spaces.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Name of the space (e.g. “Work”, “Leadership”). Max 30 characters.
emoji	string	No	Emoji for the space (e.g. ”💼”, ”🚀“)

Response

{
  "id": 3,
  "name": "Leadership",
  "emoji": "👑",
  "wins_count": 0
}

Notes

• Space names must be unique per user (case-insensitive)
• Returns a 402 equivalent if you’ve hit the free plan limit (3 spaces)

---

list_spaces

List all spaces (categories) for organizing wins. No parameters required.

Response

{
  "spaces": [
    {
      "id": 1,
      "name": "Work",
      "emoji": "💼",
      "wins_count": 28
    },
    {
      "id": 2,
      "name": "Personal",
      "emoji": "🌱",
      "wins_count": 12
    }
  ],
  "count": 2
}

---

list_tags

List all tags used to categorize wins. Use these tag names when logging or filtering wins. No parameters required.

Response

{
  "tags": [
    {
      "id": 1,
      "name": "impact",
      "wins_count": 15
    },
    {
      "id": 2,
      "name": "shipped",
      "wins_count": 22
    }
  ],
  "count": 2
}