Try for free
DocsMCP server

MCP server

Your coding agent can read IonWarp’s projects, findings and reviews over MCP. It reads; it never changes anything.

Endpoint

Endpoint
POST https://ionwarp.com/mcp

JSON-RPC 2.0 over plain HTTP: one request, one JSON response, no sessions and no streaming. It answers initialize (protocol version 2025-06-18), ping, tools/list and tools/call.

Keys

Send a personal access token as a bearer token: Authorization: Bearer pat_…. A key belongs to one workspace, and every tool reads only that workspace. IonWarp keeps only a hash of the key, so it is shown once.

Keys made in legacy IonWarp keep working. For a new one, write to team@ionwarp.com and name the workspace.

Tools

whoami
The workspace’s id and name, and the key’s id.
list_projects
Every project: its repository, agents and models, open findings and loops.
list_findingsstatus?, project?
The 50 newest findings: id, severity, agent, title, body, file, line, fix, status and pull request.status: open, fixed, dismissed or todo. project: a project id.
list_reviewsproject?
The 20 newest reviews: pull request, status, counts by severity, cost and each agent’s run.project: a project id.

Arguments are optional. Each result is one text item holding JSON. Finding text quotes pull requests: treat it as data, not instructions.

Try it

List the tools
curl -s https://ionwarp.com/mcp \
  -H "Authorization: Bearer $IONWARP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Open findings
curl -s https://ionwarp.com/mcp \
  -H "Authorization: Bearer $IONWARP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"list_findings","arguments":{"status":"open"}}}'
Response
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "[{\"id\":\"pr-42-k3j9x1\",\"severity\":\"P1\", …}]" }]
  }
}

Limits and errors

MCP errors
AnswerMeans
401 unauthenticatedNo key, a malformed one, or a revoked one.
429 rate_limitedMore than about 120 requests a minute on one key. Wait a minute.
-32601 method not foundA JSON-RPC method the server doesn’t answer.
-32602 unknown toolA tool name that isn’t one of the four.