mcpField
X
x402 Crypto Market Structure

x402 Crypto Market Structure

Local
github.com/tunedforaiFinance1Updated 25w ago
Repository

About x402 Crypto Market Structure

x402 Crypto Market Structure is an MCP server for AI agents that provides crypto market data and analysis through seven stateless tools. It covers cross-exchange order flow, macro conditions, address risk, and lightweight queries for tokens beyond its fixed coverage list.

Key features

  1. 01Cross-exchange market snapshots
  2. 02Order flow and macro analysis
  3. 03Wallet address risk scoring
  4. 04Light coverage for any token
  5. 05API pricing and service details

Use cases

  1. 01Check market conditions before a trade
  2. 02Analyze cross-exchange flows
  3. 03Assess EVM or Solana address risk

MCP support

The stdio MCP server exposes seven tools for compatible clients to retrieve market snapshots, order flow, analysis, and address risk. MCP calls are free with rate limits; paid REST endpoints are available for higher-throughput production use.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "x402-mcp-tunedforai": {
      "command": "npx",
      "args": [
        "-y",
        "@tunedforai/x402-mcp"
      ]
    }
  }
}
Run commandnpx -y @tunedforai/x402-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@tunedforai/x402-mcp

Tools

7

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
symbolstringNoToken symbol, e.g. BTC, WCT, PEPE
briefenumNoUse off for fast structured data, full for Kimi briefoff | full

Details

From the project README

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.

npm version License: MIT

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):

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@tunedforai/x402-mcp"]
    }
  }
}
Claude Code
claude mcp add x402 -- npx -y @tunedforai/x402-mcp
Cline / Continue / other MCP clients

Use the same npx -y @tunedforai/x402-mcp invocation as the stdio command.

Manual
npm install -g @tunedforai/x402-mcp
x402-mcp  # runs the stdio server

Tools

All 7 tools are stateless. No API key, no auth, no setup. Just call them.

ToolWhat it returnsREST equivalentFree via MCP / Paid REST
marketLightAny-token CoinGecko-backed market coverage: price, momentum, rank, liquidity/exchange context, and risk flags. Defaults to brief=off; set brief=full for Kimi briefPOST /data/lightFree / $0.05
marketSnapshotFree 16-field MCP subset: live price, funding, OI, buy/sell ratio, fear/greedPOST /dataFree / $0.20
marketAnalyzeMacro regime, DXY, VIX, directional signal + confidencePOST /analyze/marketFree / $0.25
marketOrderflowCross-exchange CVD, whale activity, liquidation pressurePOST /analyze/orderflowFree / $0.50
marketFullSnapshot + orderflow + LLM-synthesized analysisPOST /analyze/fullFree / $0.75
addressRiskWallet risk score (mixers, sanctions, counterparties). EVM + SolanaPOST /analyze/addressFree / $0.25
apiInfoPricing, quick-start, migration detailsGET /api_infoFree
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.

Every marketSnapshot response must keep the REST CTA:

This is a 16-field MCP subset. Paid REST /data at x402.tunedfor.ai ($0.20 USDC) returns the full 70-field snapshot including on-chain metrics, sentiment, and historical percentiles. No API key, pay-per-call from any wallet.

Examples

Pre-trade check
You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
     (mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
     Snapshot 12 sec old.
Cross-exchange orderflow
You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
     Whale activity: 8 large bars across Binance/Coinbase/Bybit.
     Liquidations: $890K longs, $230K shorts. Pressure: bearish.

Free MCP vs Paid REST

The MCP wrapper is free with rate limits — perfect for testing, prototyping, low-frequency agent workflows, and personal use.

For production agents (24/7 polling, multi-token monitoring, backtesting at scale), use the paid REST endpoints at x402.tunedfor.ai. REST is:

  • Pay-per-call in USDC on Base or Solana via the x402 protocol
  • No API keys — your agent signs payment locally; the private key never leaves your machine
  • Rate-limited to 60 calls/minute and 200 calls/hour per wallet — prevents stripmining; 429 on breach
  • No subscriptions — no monthly minimums

Call apiInfo from any MCP client to get the current pricing schedule, migration guide, and SDK examples.

How x402 payment works (REST tier)

When your agent calls a paid REST endpoint:

  1. First request returns HTTP 402 Payment Required with the price
  2. Agent signs a USDC payment locally (private key never leaves the agent)
  3. Agent retries with the payment header attached
  4. Server verifies on-chain settlement and returns the data

No accounts, no API keys, no credit cards. Just USDC and a wallet.

Data sources

  • Price + ticker: OKX, Coinbase public APIs
  • Funding / OI / liquidations: Coinalyze (commercial license)
  • On-chain metrics, exchange flows, whale ratios: licensed third-party institutional data
  • Cross-exchange orderflow (CVD, whale bars, liq aggregations): WebSocket aggregator across 20 exchanges into InfluxDB, normalized into 1-minute bars
  • Macro context (DXY, VIX, Treasury yields): FRED + Finviz
  • Fear & Greed Index: alternative.me

We don't redistribute raw exchange data — we serve derived, computed aggregates. All raw source fields are transformed into our own composite signals before responses are returned.

Links

License

MIT © Tuned For AI

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.