AgentData MCP Server

Model Context Protocol server exposing 16 crypto market data tools for Claude Desktop, Cursor, and any MCP-compatible AI client. Payments via x402 / USDC on Base Mainnet.

What this is

A thin MCP wrapper around the AgentData API — a production x402 service on Base Mainnet. Any MCP-compatible LLM can use these 16 tools with no setup beyond adding one line to your client config.

Two modes

Proxy mode (default) — No wallet needed. When a tool is called, the server returns the x402 payment instructions so the MCP client can handle payment however it prefers.

Auto-pay mode — Set AGENTDATA_BUYER_PRIVATE_KEY to a wallet funded with USDC on Base. The server signs ERC-3009 TransferWithAuthorization automatically using viem. Payments are gasless for the buyer — the facilitator covers settlement gas.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Option 1: Remote MCP (easiest, no install)

{
  "mcpServers": {
    "agentdata": {
      "url": "https://agentdata-api.com/mcp"
    }
  }
}

Option 2: Local stdio

{
  "mcpServers": {
    "agentdata": {
      "command": "npx",
      "args": ["-y", "agentdata-mcp"],
      "env": {
        "AGENTDATA_BUYER_PRIVATE_KEY": "0xYourWalletKeyHere"
      }
    }
  }
}

Restart Claude Desktop. The tools become available immediately.

Cursor

Settings → MCP → Add Server with the same config as above.

Install from source

git clone https://github.com/speteai/agentdata-mcp.git
cd agentdata-mcp
npm install
node index.js

Available Tools

Tool	Price	Use case
`get_crypto_prices`	$0.001	Real-time BTC/ETH/SOL/BNB/XRP prices
`get_funding_rates`	$0.001	Perp funding with long/short bias
`get_market_overview`	$0.002	Full market sentiment + arb signals
`get_volatility`	$0.001	24h vol, range, annualized
`get_liquidation_levels`	$0.002	Leverage-based liq zones
`get_correlation`	$0.001	30-day correlation matrix
`get_gas_prices`	$0.001	Multi-chain gas (Base/ETH/SOL)
`get_base_activity`	$0.002	Base network TPS + blocks
`get_defi_yields`	$0.002	Top yields from DefiLlama
`get_arbitrage_opportunities`	$0.003	Cross-exchange spreads
`get_dex_vs_cex`	$0.003	DEX vs CEX price comparison
`get_technical_indicators`	$0.002	RSI, MACD, BB, ATR
`get_support_resistance`	$0.003	S/R via fractal analysis
`get_sentiment`	$0.001	Fear & Greed + composite
`get_stablecoin_health`	$0.001	USDC/DAI peg monitoring
`get_historical`	$0.005	OHLCV for backtesting

Environment Variables

Variable	Default	Description
`AGENTDATA_BUYER_PRIVATE_KEY`	—	Wallet for auto-pay (optional)
`AGENTDATA_BASE_URL`	`https://agentdata-api.com`	Override API base URL

Cost Economics

For an agent querying all 16 tools once: ~$0.031 USDC. For common queries (prices + sentiment): ~$0.002 USDC per full context update.

Fund your buyer wallet with $5 USDC → good for ~2500 sentiment checks or ~150 full backtesting queries.

No ETH needed on the buyer wallet. The AgentData facilitator pays settlement gas.

agentdata-api — the underlying service
elizaos-plugin-agentdata — ElizaOS plugin version
Live service: https://agentdata-api.com
Admin dashboard: https://agentdata-api.com/admin

Keywords

Model Context Protocol, MCP server, Claude Desktop MCP, Cursor MCP, crypto market data MCP, x402 MCP, AI agent tools, agentic payments, USDC micropayments, Base Mainnet API, DeFi data for AI, crypto tools for LLM, autonomous agent data, agent economy, DeFAI

License

MIT — see LICENSE.

agentdata-mcp