Odel
x402 crypto mcp

x402 crypto mcp

Local
@yunaremaiaTypeScriptUpdated 3w ago

Crypto market data via x402: prices, convert, indicators, yields, gas, tx status, balances, ENS.

x402 Crypto MCP Server

MCP server that aggregates 6 x402 crypto backends as tools for AI agents: prices, sentiment, funding rates, technical indicators, DeFi yields, gas prices, on-chain tx status, balances, ERC-20 info, ENS, and chain state — exposed as 23 stdio tools and 26 HTTP tools (including the combined market_overview / get_market_overview, the batch get_prices, raw OHLCV candle_history / get_candles, top movers top_movers / get_top_movers, token conversion convert / get_conversion, transaction status tx_status / get_tx_status + solana_tx_status / get_solana_tx_status, wallet balances wallet_balance / get_wallet_balance

  • solana_balance / get_solana_balance, the Fear & Greed series fng_history / get_fng_history, and open interest open_interest / get_open_interest).

Tools (STDIO Transport)

ToolDescriptionService
crypto_pricesLive USD prices for 20+ tokensmulti-chain-price-oracle
top_moversTop 24h gainers and losers by market capmulti-chain-price-oracle
convertConvert amount between two tokens (live prices)multi-chain-price-oracle
tx_statusEVM tx status: landed/confirmed/failed/pending (6 chains)tx-status-oracle
solana_tx_statusSolana tx status: confirmed/failed/not_foundtx-status-oracle
wallet_balanceEVM wallet native balance (ETH, 6 chains)tx-status-oracle
solana_balanceSolana wallet SOL balancetx-status-oracle
token_infoValidate ERC-20: symbol, name, decimals, supplytx-status-oracle
token_balanceERC-20 balance of a wallet (decimals-aware, e.g. USDC)tx-status-oracle
ens_reverseReverse ENS lookup: address → .eth nametx-status-oracle
block_heightCurrent block height / slot (EVM + Solana)tx-status-oracle
ens_resolveForward ENS: .eth name → addresstx-status-oracle
market_sentimentFear & Greed index + global market metricscrypto-market-sentiment
fng_historyFear & Greed daily series (1-90 days) + trend signalscrypto-market-sentiment
open_interestPerp open interest (contracts + USD value)crypto-market-sentiment
funding_ratePerp funding rate from Binance USDT futurescrypto-market-sentiment
technical_indicatorsRSI, MACD, EMA, SMA, volatility, ATR + signalstechnical-indicators-oracle
candle_historyRaw OHLCV candles (open, high, low, close, volume, timestamp)technical-indicators-oracle
market_overviewCombined: prices + sentiment + funding in one callall 3 services
defi_yieldsTop DeFi yields across 40+ chains (15,000+ pools)defi-yield-aggregator
gas_priceGas prices on 7 EVM chains (gwei/wei)multi-chain-gas-oracle
yield_pool_metricsAPY/TVL snapshots for Aave V3 / Uniswap V3 poolsyield-pool-watcher
fresh_marketsNew AMM pairs in the last N minutesfresh-markets-watch

Tools (HTTP Transport - Vercel/Smithery)

ToolDescriptionService
get_priceGet current price for any token on supported chainsmulti-chain-price-oracle
get_pricesBatch: current prices for up to 20 tokens in one callmulti-chain-price-oracle
get_top_moversTop 24h gainers and losers by market capmulti-chain-price-oracle
get_conversionConvert amount between two tokens (live prices)multi-chain-price-oracle
get_tx_statusEVM tx status via x402 (6 chains)tx-status-oracle
get_solana_tx_statusSolana tx status via x402tx-status-oracle
get_wallet_balanceEVM wallet balance (ETH) via x402tx-status-oracle
get_solana_balanceSolana wallet SOL balance via x402tx-status-oracle
get_token_infoERC-20 token metadata via x402tx-status-oracle
get_token_balanceERC-20 wallet balance via x402tx-status-oracle
get_ens_reverseReverse ENS lookup via x402tx-status-oracle
get_block_heightBlock height / slot via x402tx-status-oracle
get_ens_resolveForward ENS resolution via x402tx-status-oracle
get_market_sentimentFear & Greed Index (Alternative.me)crypto-market-sentiment
get_fng_historyFear & Greed daily series (1-90 days) + trendcrypto-market-sentiment
get_open_interestPerp open interest (contracts + USD value)crypto-market-sentiment
get_funding_ratesPerpetual funding rates across exchangescrypto-market-sentiment
get_technical_indicatorsRSI, MACD, EMA, SMA for any symbol/timeframetechnical-indicators-oracle
get_candlesRaw OHLCV candle history (up to 500 candles)technical-indicators-oracle
get_defi_yieldsSupply/borrow APY across protocolsdefi-yield-aggregator
get_gas_priceEIP-1559 gas fees for EVM chainsmulti-chain-gas-oracle
get_multi_chain_gasGas prices for multiple EVM chains at oncemulti-chain-gas-oracle
get_pool_metricsYield pool APY/TVL/fee metrics across DEXesyield-pool-watcher
get_pool_alertsPool alerts (APY spikes, new pools, TVL changes)yield-pool-watcher
scan_new_pairsDiscover new AMM pairs on DEXesfresh-markets-watch
get_market_overviewCombined: BTC/ETH/SOL prices + Fear & Greed + BTC funding in one callall 3 services

Install

npx x402-crypto-mcp

Or globally:

npm install -g x402-crypto-mcp

Use in Claude Desktop / Cursor / any MCP client

{
  "mcpServers": {
    "x402-crypto": {
      "command": "npx",
      "args": ["x402-crypto-mcp"]
    }
  }
}

For HTTP transport (Vercel/Smithery):

{
  "mcpServers": {
    "x402-crypto": {
      "url": "https://x402-mcp-server-o8wskr5pr-yunares-projects.vercel.app/api/mcp"
    }
  }
}

x402 Payments

All backend services use x402 pay-per-call on Base mainnet (USDC). The MCP server returns 402 challenges with payment details when you need to pay. Your agent must handle x402 payments to access the data.

Data Sources

  • CoinGecko (prices) — free, 60s cache
  • Binance (funding rates, klines) — free
  • Alternative.me (Fear & Greed) — free
  • DeFiLlama (yields) — free, 5min cache
  • Public RPCs (gas) — free, 30s cache
  • The Graph (pool metrics) — free
  • EVM RPCs (new pairs) — free

GitHub

https://github.com/yunaremaia/x402-crypto-mcp