Mapixa for agents
Mapixa's public desk over MCP: the desk's grade (A, B, C or NO) with the written rule texts behind it, a coin card by mint, the day's counts and the market's volume reading. Every number carries its age.
Connect
Server: https://app.mapixa.gg/mcp, MCP over Streamable HTTP. A POST carries one JSON-RPC message and the answer is JSON; there is no stream and no session to keep. Everything beyond the five read tools below needs a Bearer token.
Without a token: your agent POSTs tools/list or a tools/call of the five read tools directly, with no initialize and one call per request. They answer anonymously, 60 requests a minute and 5,000 a UTC day per address. An MCP client such as Claude Code still signs in: its initialize gets the 401 that starts sign-in. A free personal token counts per account instead (the limits below) and opens your own paper book.
- Sign in at app.mapixa.gg. The account is free.
- Open Settings → MCP / connectors and create a token. Leave «paper trades too» unticked: the token then only reads.
- The app shows the token once. Keep it in your agent's secret store as MAPIXA_TOKEN, never in a chat or a post.
A client with OAuth 2.1 (discovery, dynamic client registration, PKCE) needs no personal token: it gets its own access token by itself, starting from the server's 401, after you sign in and allow on the consent card.
# without a token: the five read tools
curl -s https://app.mapixa.gg/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mapixa_health","arguments":{}}}'
# Claude Code
claude mcp add --transport http mapixa https://app.mapixa.gg/mcp \
--header "Authorization: Bearer $MAPIXA_TOKEN"
# any HTTP client, with the token
curl -s https://app.mapixa.gg/mcp \
-H "Authorization: Bearer $MAPIXA_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mapixa_health","arguments":{}}}'Limits per account: 60 requests a minute and 2,000 a UTC day. Past a limit the answer is HTTP 429 with Retry-After in seconds.
Free today. Paid agent access through x402 is planned and not built; no tool here asks for a payment.
Tools
| Tool | Arguments | What it returns |
|---|---|---|
mapixa_desk | blocks (optional): calls, day, market, fx, x, legend | The desk's latest graded coins with mint, grade, reasons and seven lights (calls.total counts all the rows, calls.more the rows not sent), the day's counts by grade, the market reading, SOL/USD from Jupiter, the sources and their freshness. |
mapixa_coin | mint | One coin's public card: the grade and its reasons, the shield, the on-chain facts (pool, launchpad, token program, age, mint and freeze authority) and three chain lights. Only coins the desk has seen have a card. |
mapixa_health | none | Whether the desk is fresh: the age of the last update and of the last price tick. |
mapixa_lessons | lang (optional): en, sk | The public lessons' index: id, tier, title. |
mapixa_lesson | id, lang (optional) | One lesson: the claim, the body, the rule and its sources. |
The grades: A meets the desk's rules · B close to the rules · C discovery, a coin found without a call · NO (the code NIE in the data) stopped by the shield, a safety rule.
The server also lists tools for an account's own paper book; the skill file below does not use them.
What an answer carries
- Every answer carries as_of_ms, and most carry age_ms and sources. A block with stale_s is stale once its reading is older than that many seconds.
- Every *_ms field is UTC epoch milliseconds. A time for a person is Basel time (Europe/Zurich) with CET or CEST, day before month: «8.11. 15:54 CET».
- The reasons and the market words are the desk's rule texts in Slovak; the skill file carries a glossary.
{"contract":"mapixa.coin.v1","mint":"2HhH7LwfNHrxqMrSoXZ6Ri7GdmRYSJ4e8qSra9Krpump","symbol":"forg","verdict":"C",
"dossier":{"reasons":["objav: coin bez callu v desku",
"mcap ≤ $250k ✓ · vek ≥ 10 min ✓ · nákupy 1 h ≥ 50 ✓ · objem 5 min rastie ✗"],
"facts":{"dex_id":"pumpswap","quote_is_sol":true,"age_min":17.86,"graduated":true,
"mint_authority":false,"freeze_authority":false},
"shield":{"ok":true,"reasons":[]}},
"as_of_ms":1794149580268,"age_ms":99213,"sources":["chain","dom"]}What your agent says
- It never tells anyone to buy, sell or hold a coin: a grade is the result of written rules, not advice, and the agent's own rules decide.
- It quotes every number with its age and says «stale» when a reading is stale.
- It writes the grade NIE as NO, in every language.
Contract
The public answers follow the contract mapixa.public.v1 (its field list: mapixa.public.allowlist.v1): a field leaves Mapixa only when the public field list names it. The desk answers with contract mapixa.desk.v1, a coin card with mapixa.coin.v1, health with mapixa.public.v1.
Skill file
The same instructions as a skill file for agents, under the MIT licence: SKILL.md and metadata.json, in the format of ClawPump's community skills (github.com/Clawpump/agents-skills).