AgentData — crypto market data with a checkable record

Official34 toolsLive

by speteai · JavaScript

Verifiable crypto signals, recorded history and always-on monitoring for AI agents via x402 on Base.

io.github.speteai/agentdata-mcp — AgentData MCP Server

The io.github.speteai/agentdata-mcp server is a Model Context Protocol (MCP) server that exposes a live AgentData crypto catalogue to MCP clients such as Claude Desktop and Cursor. It provides verifiable crypto signals, recorded history, and always-on monitoring for AI agents via x402 using USDC on Base Mainnet.

🛠️ Key Features

Verifiable crypto signals
Recorded history
Always-on monitoring
MCP wrapper for the AgentData API
Tool count: 34

🚀 Use Cases

Connecting AI agents to the live AgentData crypto catalogue through MCP
Accessing monitored crypto data and history in MCP clients
Payments integration via x402 and USDC on Base Mainnet

⚡ Developer Benefits

Standard Model Context Protocol support for MCP clients
Focused access to AgentData API resources through MCP
Repository-listed topics include model-context-protocol and mcp-server

⚠️ Limitations

Description provided does not enumerate individual tools or authentication details beyond x402 and USDC on Base Mainnet.

Topics

agent-toolsagenticai-agentsbase-mainnetclaudeclaude-desktopcryptocrypto-apimcpmcp-servermodel-context-protocolusdcx402

Captured live from the server via tools/list.

get_overnight_risk_brief

Decision-ready overnight risk brief ($0.015 USDC): DEX-vs-CEX spreads, liquidation zones, funding predictions, sentiment, stablecoin health, and recorded changes since this wallet last called it. Same total price as the five parts, one settlement instead of five.

Parameters1

payment

string

optional

Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_changes_since_last_call

Only what changed for a signal since THIS wallet last paid for it ($0.001 USDC — cheaper than any full payload). Replaces repeated polling: the server keeps the cursor, keyed to your wallet, so you never re-download or re-diff data you already have. Requires signal=. First call returns the last 24h.

Parameters2

signal	string	required	sentiment, funding-rates, liquidation-levels, volatility, correlation, positioning, supply, stablecoin-health, macro-onchain, defi-yields, dex-vs-cex, arbitrage-opportunities, funding-predictions
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string",
      "description": "sentiment, funding-rates, liquidation-levels, volatility, correlation, positioning, supply, stablecoin-health, macro-onchain, defi-yields, dex-vs-cex, arbitrage-opportunities, funding-predictions"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  },
  "required": [
    "signal"
  ]
}

watch_condition

Register a standing condition and let the always-on server watch it for you ($0.010 USDC, up to 168h). An agent only exists while it runs and cannot wait; this is that missing faculty. Poll watch_status free instead of paying for repeated data calls.

Parameters6

signal	string	required
subject	string	optional	e.g. BTC_USDT
op	string	required
threshold	number	required
hours	number	optional	lifetime, 1-168, default 24
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string"
    },
    "subject": {
      "type": "string",
      "description": "e.g. BTC_USDT"
    },
    "op": {
      "type": "string",
      "enum": [
        "above",
        "below"
      ]
    },
    "threshold": {
      "type": "number"
    },
    "hours": {
      "type": "number",
      "description": "lifetime, 1-168, default 24"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  },
  "required": [
    "signal",
    "op",
    "threshold"
  ]
}

try_crypto_prices

FREE SAMPLE, no payment: real-time prices for BTC, ETH, SOL, BNB, XRP. Rate-limited to 30 requests/min. The paid get_crypto_prices ($0.002 USDC) is the same data without the limit.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

try_sentiment

FREE SAMPLE, no payment: current market sentiment. Rate-limited to 30 requests/min. The paid get_sentiment is the same data without the limit.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

try_funding_rates

FREE SAMPLE, no payment: perpetual funding rates. Rate-limited to 30 requests/min. The paid get_funding_rates ($0.002 USDC) is the same data without the limit.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_signal_calibration

FREE. How often our own signals turned out right, scored against a naive baseline. Every claim is written down before the outcome exists and scored afterwards from our own recorded series. Read this before trusting any signal here — including to find out which ones we cannot yet justify charging for.

Parameters1

days

number

optional

window, default 30

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "window, default 30"
    }
  }
}

get_market_pulse

Bundle for $0.018 USDC: 8 signals in one call and one payment — sentiment, liquidation levels, volatility, correlation, funding predictions, positioning, supply, stablecoin health. Buying them separately costs $0.022 and eight settlements.

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_crypto_prices

Real-time prices for BTC, ETH, SOL, BNB, XRP ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_funding_rates

Perpetual funding rates with long/short signals ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_funding_predictions

Predicted next funding rate for BTC/ETH/SOL on MEXC, with time to settlement ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_market_overview

Full market overview with sentiment + arb signals ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_volatility

24h volatility for BTC/ETH/SOL ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_liquidation_levels

Estimated liquidation zones by leverage 5x/10x/20x ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_correlation

30-day price correlation matrix ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_gas_prices

Multi-chain gas prices Base/ETH/SOL ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_base_activity

Base network TPS + block activity ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_defi_yields

Top DeFi yields (Aave/Compound/Morpho/Pendle) ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_arbitrage_opportunities

Cross-exchange spreads MEXC/Binance/Bybit/OKX ($0.005 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_dex_vs_cex

DEX vs CEX price comparison ($0.005 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_technical_indicators

RSI, MACD, Bollinger Bands, ATR ($0.003 USDC)

Parameters3

symbol	string	optional
interval	string	optional
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "default": "BTCUSDT"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d"
      ],
      "default": "1h"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_support_resistance

S/R levels via fractal analysis ($0.005 USDC)

Parameters2

symbol	string	optional
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "default": "BTCUSDT"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_sentiment

Fear & Greed + composite sentiment ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_stablecoin_health

USDC/DAI depeg monitoring ($0.002 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_historical

Historical OHLCV candles ($0.010 USDC)

Parameters4

symbol	string	optional
interval	string	optional
limit	integer	optional
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "default": "BTCUSDT"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d"
      ],
      "default": "1d"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_positioning

Trader positioning: open interest, long/short ratios (global + top traders), funding — Binance + CoinEx ($0.005 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_etf_flows

Spot BTC & ETH ETF daily net flows (institutional demand, USD millions) — latest + 30-day history ($0.005 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_macro_onchain

Macro & on-chain context: stablecoin supply, BTC/ETH dominance, market cap, BTC network fundamentals, Fear & Greed, trending ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_supply

Circulating/total/max supply + circ/total overhang ratio per major coin — structural sell-pressure signal ($0.003 USDC)

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_signal_history_7d

Recorded hourly history of a derived signal, most recent 7 days ($0.005 USDC). Cannot be reconstructed from public sources after the fact.

Parameters2

signal	string	required	Which recorded signal, e.g. sentiment, volatility, funding-rates
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string",
      "description": "Which recorded signal, e.g. sentiment, volatility, funding-rates"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  },
  "required": [
    "signal"
  ]
}

get_signal_history_30d

Recorded hourly history of a derived signal, most recent 30 days ($0.012 USDC).

Parameters2

signal	string	required	Which recorded signal
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string",
      "description": "Which recorded signal"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  },
  "required": [
    "signal"
  ]
}

get_signal_history_full

Complete recorded hourly history of a derived signal ($0.020 USDC).

Parameters2

signal	string	required	Which recorded signal
payment	string	optional	Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key.

Raw schema

{
  "type": "object",
  "properties": {
    "signal": {
      "type": "string",
      "description": "Which recorded signal"
    },
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  },
  "required": [
    "signal"
  ]
}

get_arbitrage_spread_history

30 days of hourly cross-exchange spreads (MEXC/Binance/Bybit/OKX) ($0.015 USDC). Every venue publishes its own prices; nobody archives the spread between them.

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

get_funding_accuracy

Track record of our funding predictions scored against the rates observed afterwards, over 30 days ($0.015 USDC).

Parameters1

payment

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "payment": {
      "type": "string",
      "description": "Optional. Base64 x402 payment payload you signed yourself (ERC-3009 TransferWithAuthorization, USDC on Base). Call without it once to receive the payment requirements, sign those, then call again with this argument. This server forwards the payload and never holds a key."
    }
  }
}

README.md10 KBView on GitHub

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)

json

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

Option 2: Local stdio with auto-pay

json

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

bash

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.

Tool	Price	What it gives you
`get_overnight_risk_brief`	$0.015	Decision-ready overnight risk brief for $0.015 USDC: DEX-vs-CEX spreads, liquidation zones, funding predictions, sentiment, stablecoin health, and recorded changes since this wallet last called it. Same total price as the five parts, one settlement instead of five.
`try_crypto_prices`	free	FREE SAMPLE, no payment: real-time prices for BTC, ETH, SOL, BNB, XRP. Rate-limited to 30 requests/min. get_crypto_prices ($0.002 USDC) is the same data without the limit.
`try_sentiment`	free	FREE SAMPLE, no payment: current market sentiment. Rate-limited to 30 requests/min. get_sentiment is the same data without the limit.
`try_funding_rates`	free	FREE SAMPLE, no payment: perpetual funding rates. Rate-limited to 30 requests/min. get_funding_rates ($0.002 USDC) is the same data without the limit.
`get_signal_history_7d`	$0.005	The last 7 days of a recorded signal, not just its current value. Costs $0.005 USDC. Every recorded day is anchored on Base — verify at /anchors?verify=YYYY-MM-DD.
`get_signal_history_30d`	$0.012	The last 30 days of a recorded signal. Costs $0.012 USDC. Anchored on Base like every recorded day.
`get_signal_history_full`	$0.020	The complete recorded series for a signal. Costs $0.020 USDC. Anchored on Base like every recorded day.
`get_arbitrage_spread_history`	$0.015	30 days of hourly cross-exchange spreads (MEXC/Binance/Bybit/OKX). Costs $0.015 USDC. Every venue publishes its own prices; nobody archives the spread between them.
`get_funding_accuracy`	$0.015	Track record of our funding predictions scored against the rates observed afterwards, over 30 days. Costs $0.015 USDC. Read it before paying for get_funding_predictions.
`get_market_pulse`	$0.018	Bundle for $0.018 USDC: 8 signals in one call and one settlement — sentiment, liquidation levels, volatility, correlation, funding predictions, positioning, supply, stablecoin health. Bought separately they cost $0.022 and eight settlements.
`get_funding_predictions`	$0.003	Predicted next funding rate for BTC/ETH/SOL on MEXC, with time to settlement. Costs $0.003 USDC. Check get_signal_calibration first — this signal is scored openly and does not yet beat a naive baseline on mean error.
`get_positioning`	$0.005	Long/short positioning ratios across venues. Costs $0.005 USDC.
`get_etf_flows`	$0.005	Daily spot BTC/ETH ETF net flows in millions USD, with 30 days of history. Costs $0.005 USDC.
`get_macro_onchain`	$0.003	Macro on-chain indicators. Costs $0.003 USDC.
`get_supply`	$0.003	Circulating, total and max supply for 18 coins, with the circulating-to-total ratio. A ratio below 1 under active emission is supply overhang. Costs $0.003 USDC.
`get_changes_since_last_call`	$0.001	Only what changed for a signal since THIS wallet last paid for it. Costs $0.001 USDC — cheaper than any full payload. The server keeps the cursor, keyed to your wallet, so you never re-download or re-diff data you already hold. First call returns the last 24h.
`watch_condition`	$0.010	Register a standing condition and let the always-on server watch it for you. Costs $0.010 USDC, lifetime up to 168h. Then poll watch_status for free instead of paying for repeated data calls.
`get_signal_calibration`	free	FREE. How often the signals here actually turned out right, scored against a naive baseline. Every claim is recorded before the outcome exists and scored afterwards from the recorded series. Read this before trusting any signal — including to see which ones do not yet justify their price.
`get_crypto_prices`	$0.002	Get real-time prices for BTC, ETH, SOL, BNB, XRP. Costs $0.002 USDC.
`get_funding_rates`	$0.002	Get perpetual futures funding rates for BTC/ETH/SOL with long/short signals. Costs $0.002 USDC.
`get_market_overview`	$0.003	Get full market overview with sentiment bias, arbitrage detection, funding yield. Costs $0.003 USDC.
`get_volatility`	$0.002	Get 24h volatility, range, and annualized volatility for BTC/ETH/SOL. Costs $0.002 USDC.
`get_liquidation_levels`	$0.003	Get estimated liquidation zones by leverage (5x/10x/20x) for BTC/ETH/SOL. Costs $0.003 USDC.
`get_correlation`	$0.002	Get 30-day price correlation matrix (ETH/BTC, SOL/BTC, SOL/ETH). Costs $0.002 USDC.
`get_gas_prices`	$0.002	Get current gas prices for Base, Ethereum, Solana with USD cost estimation. Costs $0.002 USDC.
`get_base_activity`	$0.003	Get Base Mainnet network activity: TPS, block stats, gas utilization. Costs $0.003 USDC.
`get_defi_yields`	$0.003	Get top DeFi yield opportunities from Aave, Compound, Morpho, Pendle (via DefiLlama). Costs $0.003 USDC.
`get_arbitrage_opportunities`	$0.005	Get cross-exchange arbitrage opportunities between MEXC, Binance, Bybit, OKX. Costs $0.005 USDC.
`get_dex_vs_cex`	$0.005	Get DEX aggregated prices vs CEX prices with spread analysis for BTC/ETH/SOL. Costs $0.005 USDC.
`get_technical_indicators`	$0.003	Get RSI, MACD, Bollinger Bands, ATR for a symbol/interval. Costs $0.003 USDC.
`get_support_resistance`	$0.005	Get support & resistance levels via fractal analysis on 4h timeframe. Costs $0.005 USDC.
`get_sentiment`	$0.002	Get composite market sentiment: Fear & Greed Index + Funding-based + composite score. Costs $0.002 USDC.
`get_stablecoin_health`	$0.002	Get stablecoin peg monitoring (USDC, DAI live depeg check) + top 10 stablecoins by market cap. Costs $0.002 USDC.
`get_historical`	$0.010	Get historical OHLCV candles for backtesting. Costs $0.010 USDC.

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

Variable	Default	Description
`AGENTDATA_BUYER_PRIVATE_KEY`	—	Wallet for auto-pay (optional)
`AGENTDATA_MAX_PAYMENT_USDC`	`0.05`	Hard per-call auto-pay cap
`AGENTDATA_SESSION_BUDGET_USDC`	`1.00`	Total auto-pay spend per process
`AGENTDATA_BASE_URL`	`https://agentdata-api.com`	Override API base URL

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.

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.

Install

Tools (34)

get_overnight_risk_briefget_changes_since_last_callwatch_conditiontry_crypto_pricestry_sentimenttry_funding_ratesget_signal_calibrationget_market_pulse

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agentdata-api.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentdata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentdata-api.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.speteai/agentdata-mcp — AgentData MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_overnight_risk_brief

get_changes_since_last_call

watch_condition

try_crypto_prices

try_sentiment

try_funding_rates

get_signal_calibration

get_market_pulse

get_crypto_prices

get_funding_rates

get_funding_predictions

get_market_overview

get_volatility

get_liquidation_levels

get_correlation

get_gas_prices

get_base_activity

get_defi_yields

get_arbitrage_opportunities

get_dex_vs_cex

get_technical_indicators

get_support_resistance

get_sentiment

get_stablecoin_health

get_historical

get_positioning

get_etf_flows

get_macro_onchain

get_supply

get_signal_history_7d

get_signal_history_30d

get_signal_history_full

get_arbitrage_spread_history

get_funding_accuracy

AgentData MCP Server

What this is

Two modes

Quick Start

Claude Desktop

Cursor

Install from source

Available Tools

Environment Variables

Cost Economics

Related

Keywords

License

Install

Remote endpoint

Related servers