AgentData MCP Server

Model Context Protocol server exposing the live AgentData crypto catalogue to Claude Desktop, Cursor and other MCP clients. Payments use x402 and USDC on Base Mainnet.

What this is

A thin MCP wrapper around the AgentData API, a production x402 service on Base Mainnet. Free tools work through the remote MCP immediately. Paid tools accept a caller-signed payment payload or auto-pay through the local stdio package.

Two modes

Proxy mode (default) — No wallet needed. Free tools return data; paid tools return canonical x402 requirements that a capable client can sign and submit.

Auto-pay mode — Set AGENTDATA_BUYER_PRIVATE_KEY to a wallet funded with USDC on Base. The package signs the exact x402 v2 requirement and retries automatically. It defaults to a 0.05 USDC per-call cap; the facilitator covers settlement gas.

Use a dedicated, low-balance buyer wallet. Never place a treasury or primary personal wallet key in an MCP configuration.

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 (free tools or externally signed payments)

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

Option 2: Local stdio with auto-pay

{
  "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

Generated from the package catalogue by npm run sync-docs. npm run check-docs and the live catalogue comparison both run before publication, so tool counts and prices cannot drift silently.

The readiness gate withholds history tools until their own record is deep enough to justify charging. Run npm run check-catalogue before publishing to compare this package with the live service.

Environment Variables

The per-call cap is not a spending limit on its own — an agent in a loop pays it on every iteration. AGENTDATA_SESSION_BUDGET_USDC is the limit that actually stops: once the process has spent it, further paid calls fail with an error instead of signing another authorization. Refused settlements cost nothing and do not count against it.

Cost Economics

get_overnight_risk_brief replaces five $0.015 calls with one $0.015 settlement. get_market_pulse bundles eight broader signals for $0.018 instead of $0.022 bought separately. The free calibration tool should be read before paying for a derived signal.

Fund your buyer wallet with $5 USDC → good for roughly 2,500 sentiment checks or 250 full-history calls.

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

Related

• 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.