AgentData — crypto market data with a checkable record

io.github.speteaiPublished by GitHub account speteaiv1.2.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server giving assistants paid, per-call crypto market data and signals — prices, funding, sentiment, memecoin risk, recorded history — settled in…

What you can do
  • Fetch prices, funding rates, volatility, correlation, liquidation zones, technical indicators, support/resistance and OHLCV candles
  • Read sentiment, positioning, ETF flows, supply, stablecoin health, gas prices, DeFi yields and macro/on-chain context
  • Compare exchanges: arbitrage spreads, DEX-vs-CEX gaps, Base network activity
  • Screen memecoins on Solana and Base with risk verdicts and new-pool listings
  • Retrieve recorded signal history (7d, 30d, full) and changes since the wallet's last call
  • Register standing watch conditions and poll their status, plus free calibration and sample tools
When to use it
Useful when an assistant needs live crypto market context, cross-exchange spread data, memecoin screening, or a recorded and anchored signal history it can check rather than trust. The free calibration and sample tools let you judge data quality before paying.
Requirements
Remote endpoint at agentdata-api.com over streamable HTTP; no account or key for free tools. Paid tools need an x402 payment payload signed by a client, or the local npm package run with npx and AGENTDATA_BUYER_PRIVATE_KEY set to a wallet funded with USDC on Base. Optional caps: AGENTDATA_MAX_PAYMENT_USDC and AGENTDATA_SESSION_BUDGET_USDC.
Before you install
Most tools cost USDC per call (roughly $0.001–$0.018), so an agent in a loop can spend repeatedly; the per-call cap alone does not stop this, only AGENTDATA_SESSION_BUDGET_USDC does. Auto-pay requires putting a wallet private key in AGENTDATA_BUYER_PRIVATE_KEY — use a dedicated low-balance wallet, never a treasury or primary wallet. Data and payments go to a third-party service.

Installation

In SourceWeft

  1. Open AgentData — crypto market data with a checkable record in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.speteai%2Fagentdata-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentdata-crypto-market-data-with-a-chec": {
      "type": "http",
      "url": "https://agentdata-api.com/mcp"
    }
  }
}

README

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.

[MCP Registry] [x402 v2] [License: MIT]

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.gitcd agentdata-mcpnpm installnode 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.

ToolPriceWhat it gives you
get_overnight_risk_brief$0.012Decision-ready overnight risk brief for $0.012 USDC: DEX-vs-CEX spreads, liquidation zones, funding predictions, sentiment, stablecoin health, and recorded changes since this wallet last called it. 20% cheaper than the five parts bought separately ($0.015), and one settlement instead of five.
get_memecoin_risk$0.005Memecoin risk verdict for one token on Solana or Base ($0.005 USDC): LOW, ELEVATED, HIGH or CRITICAL with every finding behind it — liquidity against real assets only, mint and freeze authority, honeypot and sell tax, liquidity lock, holder concentration. What a source cannot supply is reported as unknown, never as a pass. Each verdict is filed as a claim and scored publicly at /calibration after 7 days.
get_new_memecoins$0.010New memecoin pools on Solana or Base, screened every 15 minutes ($0.010 USDC): each with its risk verdict, the market at screening time and whether its 7-day claim has resolved. The same population the public track record is computed from.
try_crypto_pricesfreeFREE SAMPLE, no payment: the real-time BTC price, to judge format and source. Rate-limited to 30 requests/min. get_crypto_prices ($0.002 USDC) adds ETH, SOL, BNB and XRP. The response lists what the sample withholds.
try_sentimentfreeFREE SAMPLE, no payment: the Fear & Greed component of market sentiment. Rate-limited to 30 requests/min. get_sentiment adds the composite reading and the funding-derived component. The response lists what the sample withholds.
try_funding_ratesfreeFREE SAMPLE, no payment: the BTC perpetual funding rate. Rate-limited to 30 requests/min. get_funding_rates ($0.002 USDC) covers every tracked perpetual. The response lists what the sample withholds.
get_signal_history_7d$0.005The 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.012The last 30 days of a recorded signal. Costs $0.012 USDC. Anchored on Base like every recorded day. Offered only while those 30 days pass the readiness gate (no hole over 6h); otherwise the service answers 404.
get_signal_history_full$0.020The complete recorded series for a signal. Costs $0.020 USDC. Anchored on Base like every recorded day. Offered only while the whole series passes the readiness gate (no hole over 6h); otherwise the service answers 404.
get_arbitrage_spread_history$0.01530 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. Offered only while the 30-day record passes the readiness gate.
get_funding_accuracy$0.015Track 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. Offered only while the 30-day record passes the readiness gate.
get_market_pulse$0.018Bundle 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.003Predicted 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.005Long/short positioning ratios across venues. Costs $0.005 USDC.
get_etf_flows$0.005Daily spot BTC/ETH ETF net flows in millions USD, with 30 days of history. Costs $0.005 USDC.
get_macro_onchain$0.003Macro on-chain indicators. Costs $0.003 USDC.
get_supply$0.003Circulating, 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.001Only 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.010Register 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_calibrationfreeFREE. 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.002Get real-time prices for BTC, ETH, SOL, BNB, XRP. Costs $0.002 USDC.
get_funding_rates$0.002Get perpetual futures funding rates for BTC/ETH/SOL with long/short signals. Costs $0.002 USDC.
get_market_overview$0.003Get full market overview with sentiment bias, arbitrage detection, funding yield. Costs $0.003 USDC.
get_volatility$0.002Get 24h volatility, range, and annualized volatility for BTC/ETH/SOL. Costs $0.002 USDC.
get_liquidation_levels$0.003Get estimated liquidation zones by leverage (5x/10x/20x) for BTC/ETH/SOL. Costs $0.003 USDC.
get_correlation$0.002Get 30-day price correlation matrix (ETH/BTC, SOL/BTC, SOL/ETH). Costs $0.002 USDC.
get_gas_prices$0.002Get current gas prices for Base, Ethereum, Solana with USD cost estimation. Costs $0.002 USDC.
get_base_activity$0.003Get Base Mainnet network activity: TPS, block stats, gas utilization. Costs $0.003 USDC.
get_defi_yields$0.003Get top DeFi yield opportunities from Aave, Compound, Morpho, Pendle (via DefiLlama). Costs $0.003 USDC.
get_arbitrage_opportunities$0.005Get cross-exchange arbitrage opportunities between MEXC, Binance, Bybit, OKX. Costs $0.005 USDC.
get_dex_vs_cex$0.005Get DEX aggregated prices vs CEX prices with spread analysis for BTC/ETH/SOL. Costs $0.005 USDC.
get_technical_indicators$0.003Get RSI, MACD, Bollinger Bands, ATR for a symbol/interval. Costs $0.003 USDC.
get_support_resistance$0.005Get support & resistance levels via fractal analysis on 4h timeframe. Costs $0.005 USDC.
get_sentiment$0.002Get composite market sentiment: Fear & Greed Index + Funding-based + composite score. Costs $0.002 USDC.
get_stablecoin_health$0.002Get stablecoin peg monitoring (USDC, DAI live depeg check) + top 10 stablecoins by market cap. Costs $0.002 USDC.
get_historical$0.010Get 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

VariableDefaultDescription
AGENTDATA_BUYER_PRIVATE_KEY—Wallet for auto-pay (optional)
AGENTDATA_MAX_PAYMENT_USDC0.05Hard per-call auto-pay cap
AGENTDATA_SESSION_BUDGET_USDC1.00Total auto-pay spend per process
AGENTDATA_BASE_URLhttps://agentdata-api.comOverride 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 calls totalling $0.015 with one $0.012 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

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.

Source: README.md at commit 8387722

Tools

35

get_overnight_risk_brief

Decision-ready overnight risk brief ($0.012 USDC): DEX-vs-CEX spreads, liquidation zones, funding predictions, sentiment, stablecoin health, and recorded changes since this wallet last called it. 20% cheaper than buying the five parts separately, and one settlement instead of five.

Parameterspayment

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.

Parameterssignalrequiredpayment

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.

Parametersoprequiredhourssignalrequiredpaymentsubjectthresholdrequired

get_memecoin_risk

Memecoin risk verdict for one token on Solana or Base ($0.005 USDC): LOW, ELEVATED, HIGH or CRITICAL with every finding behind it — liquidity against real assets only, mint and freeze authority, honeypot and sell tax, liquidity lock, holder concentration. What a source cannot supply is reported as unknown, never as a pass. Each verdict is filed as a claim and scored publicly at /calibration after 7 days.

Parameterschainrequiredtokenrequiredpayment

get_new_memecoins

New memecoin pools on Solana or Base, screened every 15 minutes ($0.010 USDC): each with its risk verdict, the market at screening time and whether its 7-day claim has resolved. The same population the public track record is computed from.

Parameterschainhourspayment

try_crypto_prices

FREE SAMPLE, no payment: the real-time BTC price, to judge format and source. Rate-limited to 30 requests/min. The paid get_crypto_prices ($0.002 USDC) adds ETH, SOL, BNB and XRP. The response lists what the sample withholds.

Takes no parameters.

try_sentiment

FREE SAMPLE, no payment: the Fear & Greed component of market sentiment. Rate-limited to 30 requests/min. The paid get_sentiment adds the composite reading and the funding-derived component. The response lists what the sample withholds.

Takes no parameters.

try_funding_rates

FREE SAMPLE, no payment: the BTC perpetual funding rate. Rate-limited to 30 requests/min. The paid get_funding_rates ($0.002 USDC) covers every tracked perpetual. The response lists what the sample withholds.

Takes no parameters.

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.

Parametersdays

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.

Parameterspayment

get_crypto_prices

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

Parameterspayment

get_funding_rates

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

Parameterspayment

get_funding_predictions

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

Parameterspayment

get_market_overview

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

Parameterspayment

get_volatility

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

Parameterspayment

get_liquidation_levels

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

Parameterspayment

get_correlation

30-day price correlation matrix ($0.002 USDC)

Parameterspayment

get_gas_prices

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

Parameterspayment

get_base_activity

Base network TPS + block activity ($0.003 USDC)

Parameterspayment

get_defi_yields

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

Parameterspayment

get_arbitrage_opportunities

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

Parameterspayment

get_dex_vs_cex

DEX vs CEX price comparison ($0.005 USDC)

Parameterspayment

get_technical_indicators

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

Parameterssymbolpaymentinterval

get_support_resistance

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

Parameterssymbolpayment

get_sentiment

Fear & Greed + composite sentiment ($0.002 USDC)

Parameterspayment

get_stablecoin_health

USDC/DAI depeg monitoring ($0.002 USDC)

Parameterspayment

get_historical

Historical OHLCV candles ($0.010 USDC)

Parameterslimitsymbolpaymentinterval

get_positioning

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

Parameterspayment

get_etf_flows

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

Parameterspayment

get_macro_onchain

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

Parameterspayment

get_supply

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

Parameterspayment

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.

Parameterssignalrequiredpayment

get_signal_history_30d

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

Parameterssignalrequiredpayment

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.

Parameterspayment

get_funding_accuracy

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

Parameterspayment

Version history

1
  1. v1.2.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts