Mikka Docs

MCP server

Let Claude Code, Codex or any other MCP client work with your Mikka issues, runs and Coordinator.

Mikka runs an MCP server at https://app.aspectlylabs.com/mikka/api/mcp (Streamable HTTP). An agent connected to it acts as you, with the same access checks as the app.

Connect

claude mcp add --transport http mikka https://app.aspectlylabs.com/mikka/api/mcp

The first connection opens your browser. Sign in to Mikka and allow the agent. Access tokens last an hour and refresh on their own.

Tools

ToolWhat it does
send_to_coordinatorSends a message to your Coordinator, as if you typed it in the chat.
read_coordinator_messagesReads the conversation, optionally waiting for the Coordinator's reply.
list_issues, get_issue, search_issuesYour issues, one issue with its latest runs, or issues matching some words.
create_issue, update_issueCreate an issue, or change its title, status, priority, project, labels or agent.
link_issuesAdd or remove a parent, child, related, blocking or duplicate link.
list_runs, get_run, get_run_eventsRecent agent runs, one run with its summary, and its full event stream.
dispatch_run, send_to_run, stop_runStart a run, message a running agent, or ask a run to stop.
list_projects, list_labels, list_agentsYour projects, labels in use, and agents with their machines and repositories.
read_coordinator_memory, remember, forgetRead and edit the notes your Coordinator keeps about you.

If an action is refused, the tool returns the same error the app would show, for example when an issue no longer exists.

On this page