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
| Name | In | Type | Required | Limits | What it is |
|---|---|---|---|---|---|
body | body | object | yes | one JSON-RPC 2.0 message, up to 64 KB | initialize, tools/list or tools/call (MCP 2025-06-18, Streamable HTTP, stateless). |
Authorization | header | string | no | An 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
| HTTP | error | Cause | Fix |
|---|---|---|---|
| 401 | invalid_key | No 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. |
| 429 | rate_limited | Over 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 assistantAsk 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.