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_id	string	One of ID or name	Space ID from list_spaces
space_name	string	One of ID or name	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 more than one accessible space has the same name, the request fails. Use space_id to select the correct space.
• If both ID and name are supplied, the ID takes precedence.
• 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_id	string	No	Filter by space ID; takes precedence over name
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,
  "has_more": false
}

has_more is true when more wins matched than limit allowed, so a count of exactly limit is not mistaken for the full history.

---

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 tags attached to wins that you can currently access. Counts include only those wins. Unused tags and tags attached only to inaccessible wins are not listed. No parameters required.

Response

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

---

export_wins

Export accessible wins. Duplicate space names return an error. Use space_id to select one space.

Parameters

Parameter	Type	Required	Description
format	string	Yes	"review", "resume", or "markdown"
space_id	string	No	Filter by space ID; takes precedence over name
space_name	string	No	Filter by a unique accessible space name
since	string	No	Include wins on or after this date (YYYY-MM-DD)
until	string	No	Include wins on or before this date (YYYY-MM-DD)

The response contains the export ID, format, status, and content.