Anaxer

@anaxer/mcp

Official MCP server for the Anaxer Solana real-time data API. Add a few lines to Claude Desktop, Claude Code, or Cursor and the assistant can call typed tools over your API key: prices, token metadata, trades, wallet trades and transfers, launches, graduations, and a bounded live stream tail.

Requires Node ≥ 20. This package wraps @anaxer/sdk; it adds no gateway or wire behavior. Docs: anaxer.com/docs/mcp.

npx -y @anaxer/mcp

Setup

Set ANAXER_API_KEY in the MCP host config (never pass the key as a tool argument). Keys start with ak_; create one at console.anaxer.com/api-keys.

Claude Desktop / Claude Code / Cursor

{

"mcpServers": { "anaxer": { "command": "npx", "args": ["-y", "@anaxer/mcp"], "env": { "ANAXER_API_KEY": "ak_…" } } } }

Optional:

Tools

List tools default to limit: 20 (max 200) to conserve model context. Paginate by calling again with cursor set to the previous next; stop when next is null. History reaches back 7 days on every plan.

Trades and transfers carry each token's symbol (null until the token is resolved; key on mint, since symbols are not unique). A routed swap is one trade row per hop, all with the same signature. Transfers have no source.

Spelling: REST list tools take source (one string) or sources (array), not both. tail_stream filters use the WebSocket shape, where it is always sources (array).

tail_stream caps

• maxEvents — default 20, cap 100
• timeoutMs — default 10_000, cap 30_000
• Ends when either cap hits first; always unsubscribes before returning

Per-channel filter keys:

• trades: sources, mints, wallets, minVolumeUsd, maxVolumeUsd, solOnly (quote assets SOL/USDC/USDT rejected in mints — use solOnly: true for SOL pairs)
• transfers: wallets, mints, minVolumeUsd, maxVolumeUsd, direction (in / out, needs wallets); no sources
• creations: sources, enriched, excludeMayhem
• graduations: sources, excludeMayhem, minLiquiditySol
• prices: sources, mints

Plan rules apply as on the API: Starter trades needs mints (≤ 25) and Starter transfers needs wallets (≤ 100) or mints (≤ 25); Pro may tail every trade or transfer. Free plans have creations and graduations only.

Not included

These are intentional, not bugs:

• No list_programs.
• No remote / hosted MCP (Streamable HTTP) — local stdio only.
• tail_stream does not replay a disconnect window — it resumes live. Backfill a gap with the REST tools (list_* take from / to); see the SDK gap-recovery notes.
• No MCP resources or prompts — tools only.

Troubleshooting

1. Wrong API key on `tail_stream`. REST tools fail per call and recover as soon as you fix ANAXER_API_KEY. WebSocket unauthorized is terminal for the shared socket — restart the MCP server process (reload the host / re-run npx @anaxer/mcp) after fixing the key.
2. `subscription_limit`. Each open tail_stream holds one plan subscription until it returns (Starter allows one per channel). Overlapping tails (or a leaked subscription) can hit the cap. The server always close()s in finally; hosts normally serialize tool calls, so this is rare.
3. `invalid_filters` on `tail_stream`. The filter bag broke a channel or plan rule (for example sources on transfers, or a Starter trades tail without mints). The message names the problem.

License

MIT

About this repository

This is a read-only mirror. packages/mcp in Anaxer's private monorepo is the source of truth; this repo is regenerated from it on each release, so pull requests here cannot be merged directly. Issues are very welcome — or reach us at anaxer.com/contact.