tunedforai/x402-mcp

> Cross-exchange crypto market structure for AI agents. 20 exchanges, 26 fixed Pillar tokens plus any-token light coverage, 7 tools - light coverage, snapshot, orderflow, macro regime, full analysis, address risk, and API info. Free via MCP.
x402-mcp is a stdio MCP server that exposes x402.tunedfor.ai - a real-time crypto market structure API - as 7 tools any MCP-compatible client (Claude Desktop, Cursor, Cline, Windsurf, Claude Code) can call. Free via MCP for testing and low-frequency queries; paid REST at the same endpoints for production agents that need higher throughput.
---
Install
Claude Desktop / Cursor / Windsurf
Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, equivalent on other OS):
Claude Code
Cline / Continue / other MCP clients
Use the same npx -y @tunedforai/x402-mcp invocation as the stdio command.
Manual
---
Tools
All 7 tools are stateless. No API key, no auth, no setup. Just call them.
| Tool | What it returns | REST equivalent | Free via MCP / Paid REST |
|---|---|---|---|
| marketLight | Any-token CoinGecko-backed market coverage: price, momentum, rank, liquidity/exchange context, and risk flags. Defaults to brief=off; set brief=full for Kimi brief | POST /data/light | Free / $0.05 |
| marketSnapshot | Free 16-field MCP subset: live price, funding, OI, buy/sell ratio, fear/greed | POST /data | Free / $0.20 |
| marketAnalyze | Macro regime, DXY, VIX, directional signal + confidence | POST /analyze/market | Free / $0.25 |
| marketOrderflow | Cross-exchange CVD, whale activity, liquidation pressure | POST /analyze/orderflow | Free / $0.50 |
| marketFull | Snapshot + orderflow + LLM-synthesized analysis | POST /analyze/full | Free / $0.75 |
| addressRisk | Wallet risk score (mixers, sanctions, counterparties). EVM + Solana | POST /analyze/address | Free / $0.25 |
| apiInfo | Pricing, quick-start, migration details | GET /api_info | Free |
Token coverage
Major L1s and L2s on the snapshot tier: BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC.
Extended orderflow tier: the above plus NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM.
marketLight supports listed CoinGecko symbols beyond the fixed Pillar token list. Use it for lightweight coverage of tokens such as WCT when the fixed snapshot/orderflow tools reject a symbol. It defaults to brief=off for lower latency; request brief=full when you specifically need the Kimi-generated prose brief.
Call apiInfo from any MCP client for the authoritative current list.
---
MCP subset contract
marketSnapshot returns a free 16-field MCP subset for agent context and routing. It is not the paid REST /data schema.
Expected top-level MCP keys:
- as_of_utc
- token
- snapshot
- data_freshness
- presentation_hint
- next_steps
The snapshot object carries the 16 market data fields plus metadata. token and fetched_at are metadata keys, so a raw JSON key count may show 17 keys under snapshot even though the product contract is the 16-field market-data subset.
Do not require schema_version or coverage from MCP. Those belong to the paid REST contract unless the MCP product contract is intentionally expanded.