# KanbanZone MCP MCP > KanbanZone connects your AI agent directly to project boards for real-time workflow control. Manage tasks by simply asking questions: check board status, move cards between columns, and enforce Work-In-Progress limits without opening the app. It gives you conversational access to structured process metrics. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** kanban, agile, swimlanes, wip-limits, process-metrics, visual-management ## Description Your agent manages KanbanZone boards using natural language commands. Instead of navigating multiple screens or copy-pasting data, you tell your AI client exactly what you need—like listing all boards currently running or seeing which cards are stuck in 'Review.' You can create new tasks with `create_cards` and automatically shift their status by moving them between columns. Need to automate something? Use the webhook tools to connect board changes to external services. This MCP lets your agent read card history, track activity logs, and keep a constant eye on WIP limits per column. If you use other specialized platforms, they might require dedicated integrations; however, connecting through Vinkius makes KanbanZone accessible from any compatible AI client. ## Tools ### create_cards Adds multiple new tasks (cards) to any designated board. ### create_webhook Sets up a new automated trigger for a specified board. ### delete_webhook Removes an existing webhook from a board to stop automation triggers. ### list_boards Retrieves a list of all Kanban boards associated with the account. ### list_cards Fetches and displays the details for every card on a selected board. ### list_webhooks Retrieves all currently active webhooks linked to a specific board. ### move_card Changes the status of a card by moving it to a different column on the board. ### update_card Modifies specific data points (like priority or assignee) for an existing task. ## Prompt Examples **Prompt:** ``` Show all boards and cards in the 'Development' board by column. ``` **Response:** ``` Boards: 3. Development (28 cards), Marketing (15), Operations (12). Development: Backlog (8), To Do (6/8), In Progress (5/5 at limit), Review (4), Testing (2), Done (3). Swimlanes: Frontend, Backend, DevOps. ⚠️ In Progress at WIP limit. ``` **Prompt:** ``` Create a card 'Fix login bug' and move 'API migration' to Done. ``` **Response:** ``` Card created! 'Fix login bug' in To Do, Priority: High, Swimlane: Frontend. To Do: 6→7. Card moved! 'API migration' → Done ✅. In Progress: 5→4 (below WIP). Done: 3→4. ``` **Prompt:** ``` Show swimlane breakdown and board activity for today. ``` **Response:** ``` Swimlanes: Frontend (10 cards, 2 in progress), Backend (12 cards, 2 in progress), DevOps (6 cards, 1 in progress). Today's activity: 8 actions. 3 cards moved, 2 created, 1 archived, 2 updated. Most active: Sarah (4 actions). ``` ## Capabilities ### List all project boards The agent retrieves a list of every board available in your account. ### View and track cards on a board You can pull up specific card details or see the full roster of tasks within any given board. ### Update task status and location The agent moves a card to a different column, changing its current workflow stage. ### Add new project cards You instruct the system to create one or more new tasks on a specified board. ### Automate external triggers The agent creates, deletes, or lists webhooks, allowing board activity to trigger outside services. ## Use Cases ### The sprint review is running over time. A PM asks the agent: 'Show me all cards in Development that are stuck.' The agent uses `list_cards` and reports back exactly which tasks have not been moved for three days, allowing immediate follow-up. ### Need to onboard a new board setup. An operations lead asks the agent: 'List all boards.' The agent uses `list_boards` and provides an inventory of every active project board in one reply, saving time running through the dashboard. ### A key feature is ready to test. An engineer asks the agent: 'Move API migration card to Testing.' The agent executes `move_card` instantly, updating the board and confirming the status shift. ## Benefits - Track bottlenecks instantly. Need to know if the 'In Progress' column is hitting its WIP limit? Ask your agent to check, preventing team overload before it happens. - Automate external communication using webhooks. Instead of manually notifying a service when a card moves, use `create_webhook` to trigger an action automatically. - Never lose project context again. The MCP lets you view the full activity log and card history for any task, giving deep process insight. - Keep your work flowing efficiently. Use `move_card` through conversation to update a status, eliminating manual board manipulation. - Start new initiatives fast. Instead of opening the UI, just ask your agent to use `create_cards` to populate the backlog with tasks. ## How It Works The bottom line is that your AI agent handles all the API calls and data formatting for you. 1. Subscribe to this MCP and enter your KanbanZone API Token. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius catalog. 3. Issue a natural language command instructing the agent what board status or card action you require. ## Frequently Asked Questions **How do I list all boards using the KanbanZone MCP?** You use the `list_boards` tool. This command retrieves every board name and ID in your account, allowing you to target specific projects later. **Can I create cards programmatically with `create_cards`?** Yes. You instruct the agent on the card title, initial column, and any necessary details, and it uses `create_cards` to populate the board for you. **What is the best way to track changes in workflow? Should I use list_webhooks?** Use `list_webhooks` first. This shows all active triggers, helping you understand which external systems are already linked and what events cause automation. **How do I make sure a card is updated correctly using the KanbanZone MCP?** You should use `update_card` to modify data fields like priority or description. Always confirm the card ID before running this tool to avoid changing the wrong item. **When I use `move_card`, how do I ensure the destination column actually exists on the board?** You must specify a valid, existing column ID for the move operation to succeed. If the target column doesn't exist, the MCP will throw an error and won't change the card's state. Always check your available columns first. **Can I filter results or search parameters when running `list_cards`?** Yes, you can narrow down the data returned by `list_cards`. You typically pass filters like priority level, assignee name, or a specific swimlane ID to get only the cards that match your criteria. **If I no longer need a webhook, is it safe just to use `delete_webhook`?** Using `delete_webhook` immediately removes the connection and associated triggers. This action is permanent, so always confirm you have backed up any necessary logs before deleting webhooks. **What are the required parameters for a successful card change using `update_card`?** You need at minimum the unique Card ID and the Board ID. While some fields like description or priority are optional, updating only these core identifiers ensures stability. **Can I create and move cards across board columns?** Yes. Create cards in any column, move them across workflow stages, update details and assignees, and archive completed work. **How does KanbanZone authentication work?** KanbanZone uses **HTTP Basic Auth** with the API Token against `integrations.kanbanzone.io/v1`. This differs from the standard Bearer token pattern. **Can I organize work using swimlanes?** Yes. Browse and manage swimlanes to categorize cards by project, team, or priority within each board.