Step 01
Generate a key.
Settings → API keys → Create key. Name it after the agent that will use it.
MCP integration
Manage your dojo from any agent.
kanNINJA speaks the Model Context Protocol. Wire it into the agent you already use.
01 — The protocol
What MCP actually is.
The Model Context Protocol is a small open standard for letting AI agents call tools in your apps. Anthropic published it. Other vendors picked it up. It is now the way your agent talks to the software you already pay for.
kanNINJA ships an MCP server. You generate an API key, paste a short snippet into your agent’s config, and the agent can read your boards and move your kata. No browser tab. No copy-paste from the dashboard. The work happens where you already work.
02 — Tools you get
Fifteen verbs, in your vocabulary.
Read what is there. Move what isn’t. The same names you use on the board, exposed as tools the agent can call.
Read
list_boards.
Every dojo you can see, on demand.
get_board.
Columns, cards, members. The whole board, returned in JSON.
list_tasks.
Filter by status, assignee, due date, label, clan.
get_task.
Full detail — comments, history, attachments.
get_my_work.
Everything assigned to you, grouped by board.
search.
Text search across cards and comments. Scoped to what you can see.
Write
create_task.
A new kata, on the column you name.
update_task.
Title, description, priority, progress. Anything on the card.
move_task.
Across columns, with a comment if you want one.
add_comment.
Posts as you. Threaded with the rest.
assign_task.
To yourself, a clan member, or no one.
set_due_date.
In your workspace timezone, not the server’s.
AI-native tools (break down, estimate, suggest next, draft standup) and clan tools are next. Pro and Team tiers, when they ship.
03 — Setup
Three steps to wired.
Under a minute, in any direction.
Step 02
Paste the snippet.
Drop it into your client’s MCP config and restart the client.
Step 03
Ask for your boards.
“List my boards.” The agent calls list_boards and you’re done.
The snippet
{
"mcpServers": {
"kanninja": {
"command": "npx",
"args": ["-y", "kanninja-mcp"],
"env": { "KANNINJA_API_KEY": "ninja_live_..." }
}
}
}Replace ninja_live_... with the key from your settings page.
04 — Clients
Tested in the agents you trust.
- Claude Code
- Claude.ai
- Cursor
- ChatGPT desktop
- Zed
- Windsurf
- Continue.dev
Plus anything else that speaks MCP. The protocol is open and the server is the same on every client.
Not a developer?
There’s a one-click version for ChatGPT and Claude.
