Skip to content
AtheronDEVELOPERS
← API reference

MCP server

The Model Context Protocol server your AI tools connect to: the docs, the reference, examples by language, error lookup, the changelog, status, and, with a key, your app's settings, usage and sandbox calls.

Sign in to see your own test client ID in the samples.

POST https://developers.aton-network.org/mcp

When to use it

Connect Claude, your editor or any MCP client to it while you build.

Authentication

None for the docs tools. A test or live API key as Authorization: Bearer for your app's data; a test key with the sandbox right for sandbox calls.

Parameters

NameInTypeRequiredLimitsWhat it is
bodybodyobjectyesone JSON-RPC 2.0 message, up to 64 KBinitialize, tools/list or tools/call (MCP 2025-06-18, Streamable HTTP, stateless).
AuthorizationheaderstringnoAn API key, for the tools that read your app.

Request

# Start an MCP session by hand: one JSON-RPC message in, one answer out.
curl https://developers.aton-network.org/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

Response

http
HTTP 200
content-type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "tools": { "listChanged": false } },
    "serverInfo": { "name": "atheron-developers", "version": "0.2.0" }
  }
}

Errors

HTTPerrorCauseFix
401invalid_keyNo API key was sent, or it is not one of ours, expired or revoked.Send Authorization: Bearer with a key from the app's API keys page.
429rate_limitedOver your quota for this bucket, this minute or this day.Wait the Retry-After seconds. Requests over the limit still count, so a retry loop keeps you over it.

Good to know

  • Every tool is read-only on production. A notification is answered 202 with no body.

Security

  • Use a test key while you build. A live key never carries the sandbox right.

Ask Atlas

AI assistant

Ask anything about Sign in with Atheron, the API or the portal. You get an answer from our docs, with links to the pages it used.