# Kanbanize — how to use (mcp.ai)

Connect your Kanbanize account and use 24 tools for project management straight from your AI agent. Connect with your own API key. Kanbanize is designed to help advanced product teams apply the principles of Lean and Kanban to their work to maximize results.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kanbanize?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kanbanize_add_card_comment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kanbanize`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kanbanize/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kanbanize/add/card/comment` — Tool to add a comment to a Kanbanize card. Use when you need to add notes, updates, or any text-based information to an existing card.
  - body: { text: string, card_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/check/board/milestone` — Tool to check if a milestone is available on the specified board. Use when you need to verify milestone existence on a specific board. Returns True if the milestone is available (HTTP 204), False if n
  - body: { board_id: integer, milestone_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/check/user/is/card/watcher` — Tool to check if a user is a watcher of a specific card. Use when you need to verify if a user is watching a card.
  - body: { card_id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/delete/board` — Tool to delete a board by its ID. Use when you need to permanently remove a board from Kanbanize. Note: The board must be archived before deletion.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/delete/card` — Tool to delete a card from the Kanbanize board. Use when you need to permanently remove a card and all its associated data from the board.
  - body: { card_id: integer, exceeding_reason?: string }
- `POST https://api.mcp.ai/api/kanbanize/delete/tag` — Tool to delete a tag from Kanbanize. Use when removing a tag and optionally replacing it with another tag for all affected cards.
  - body: { tag_id: integer, replace_with_tag_id?: integer }
- `POST https://api.mcp.ai/api/kanbanize/delete/workflow` — Tool to delete a workflow for the specified board. Use when you need to permanently remove a workflow from a board.
  - body: { board_id: integer, workflow_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/board/block/reasons` — Tool to get a list of block reasons available on a board. Use when you need to retrieve available block reasons for a specific board.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/board/card/templates` — Tool to retrieve a list of card templates available on a Kanbanize board. Use when you need to see what card templates are configured for a specific board.
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/child/cards` — Tool to retrieve a list of child cards for a specified parent card. Use when you need to view all cards that are children of a given parent card in the Kanbanize hierarchy.
  - body: { page?: integer, card_id: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/column` — Tool to get the details of a specific column from a Kanbanize board. Use when you need to retrieve column information such as name, WIP limit, card ordering, or workflow configuration.
  - body: { board_id: integer, column_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/columns` — Tool to get a list of columns for a specific board in Kanbanize. Use when you need to retrieve all columns configured for a board, including their workflow assignments, positions, limits, and display 
  - body: { board_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/custom/fields` — Tool to retrieve a list of custom fields from Kanbanize with optional filtering. Use when you need to fetch custom field definitions, filter by field IDs, name, availability level, enabled status, typ
  - body: { name?: string, types?: string[], expand?: string[], field_ids?: integer[], is_enabled?: string, availability?: string[], is_immutable?: string, is_always_present?: string }
- `POST https://api.mcp.ai/api/kanbanize/get/stickers` — Tool to retrieve a list of stickers with optional filtering by sticker IDs, label, availability, and enabled status. Use when you need to fetch stickers from Kanbanize to apply to cards or to view ava
  - body: { label?: string, is_enabled?: integer, sticker_ids?: integer[], availability?: integer[] }
- `POST https://api.mcp.ai/api/kanbanize/get/user` — Tool to get the details of a specified user in Kanbanize. Use when you need to retrieve information about a user such as their username, email, real name, avatar, enabled status, language preferences,
  - body: { user_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/workflow/cycle/time/columns` — Tool to retrieve workflow's cycle time columns from a Kanbanize board. Use when you need to identify which columns are included in cycle time calculations for a specific workflow.
  - body: { board_id: integer, workflow_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/get/workspace/data/fields` — Tool to retrieve a list of data fields available on a workspace. Use when you need to fetch all custom data fields configured for a specific Kanbanize workspace.
  - body: { workspace_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/remove/board/block/reason` — Tool to make a block reason unavailable on a board. Use when you need to remove a specific block reason from a board's available options.
  - body: { board_id: integer, reason_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/remove/child/card` — Tool to remove the link between a parent card and a child card. Use when you need to unlink a child card from its parent card in Kanbanize.
  - body: { card_id: integer, child_card_id: integer, exceeding_reason?: string }
- `POST https://api.mcp.ai/api/kanbanize/set/card/block/reason` — Tool to block a Kanbanize card by setting a block reason. Use when you need to mark a card as blocked and specify the reason preventing progress.
  - body: { card_id: integer, reason_id: integer }
- `POST https://api.mcp.ai/api/kanbanize/update/board/sticker` — Tool to update the properties of a sticker for the specified board. Use when you need to modify usage limits for a sticker on a board or card.
  - body: { board_id: integer, sticker_id: integer, limit_per_card?: integer, limit_per_board?: integer }
- `POST https://api.mcp.ai/api/kanbanize/update/data/field/workspaces` — Tool to add, update, or remove a data field on one or more workspaces via batch operations. Use when you need to configure data field availability and settings across multiple workspaces.
  - body: { data_field_id: integer, workspace_ids_to_remove?: integer[], workspaces_to_add_or_update?: object[], workspace_ids_for_apply_to_all_boards_to_add?: integer[], workspace_ids_for_apply_to_all_boards_to_remove?: integer[], workspace_ids_for_value_is_locked_for_all_boards_to_add?: integer[], workspace_ids_for_value_is_locked_for_all_boards_to_remove?: integer[] }
- `POST https://api.mcp.ai/api/kanbanize/update/lane/default/setting` — Tool to update the default value of a specific lane setting in Kanbanize. Use when you need to modify default settings for a lane on a board.
  - body: { value: integer, lane_id: integer, board_id: integer, setting_name: string }
- `POST https://api.mcp.ai/api/kanbanize/update/tag` — Tool to update the specified tag in Kanbanize. Use when you need to modify tag properties like label, color, availability, or enabled status.
  - body: { color?: string, label?: string, tag_id: integer, is_enabled?: integer, availability?: integer }

## Example prompts
- "What can I do in Kanbanize?"
- "Show me a summary of my Kanbanize account"

## More
- Page: https://mcp.ai/kanbanize
- Agent spec (llms.txt): https://mcp.ai/kanbanize/llms.txt
- Postman collection: https://mcp.ai/kanbanize/postman.json