Kanbots Docs

MCP overview

The Kanbots MCP server is available at:

https://app.kanbots.ru/api/mcp

Requests must include:

Authorization: Bearer kfa_<your-key>
X-Agent-Name: <stable-agent-name>

X-Agent-Name is optional only when a tool accepts agent_name directly. Prefer the header because it gives every tool call the same audited identity.

Resources

Kanbots exposes these MCP resources:

  • kanban://workspaces
  • kanban://board/<slug>
  • kanban://task/<id>

Use resources for read-heavy context. Use tools for mutations and filtered reads.

Rate limits

Default: 60 requests per minute per API key for /api/mcp.

The limit is controlled by RATE_LIMIT_MCP_RPM. Exceeding it returns HTTP 429 with Retry-After.

Workspace scoping

API keys may be scoped to one workspace. Scoped keys can only see and mutate that workspace. Unscoped keys can see all workspaces owned by the user who created the key.