AgentData — crypto market data with a checkable record

AgentData MCP 服务

模型上下文协议服务，将实时 AgentData 加密货币目录开放给 Claude Desktop、Cursor 和其他 MCP 客户端。付款通过 x402 和 Base Mainnet 上的 USDC 完成。

这是什么

一个围绕 AgentData API 构建的轻量 MCP 封装。AgentData API 是运行于 Base Mainnet 上的生产级 x402 服务。免费工具可立即通过远程 MCP 使用。付费工具接受调用方签名的付款负载，或通过本地 stdio 程序自动付款。

两种模式

代理模式（默认） — 无需钱包。免费工具返回数据；付费工具返回规范的 x402 要求，由支持此功能的客户端签名并提交。

自动付款模式 — 将 AGENTDATA_BUYER_PRIVATE_KEY 设置为一个已存入 Base 上 USDC 的钱包。程序会为确切的 x402 v2 要求签名并自动重试。默认每次调用上限为 0.05 USDC；结算 Gas 由支付协调器承担。

请使用余额较低的专用买方钱包。切勿在 MCP 配置中放入资金库或个人主钱包的密钥。

快速开始

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

选项 1：远程 MCP（免费工具或外部签名付款）

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

选项 2：本地 stdio 自动付款

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

重启 Claude Desktop。工具将立即可用。

Cursor

在“设置”→“MCP”→“添加服务器”中使用上述相同配置。

从源代码安装

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

可用工具

由程序包目录通过 npm run sync-docs 生成。发布前会运行 npm run check-docs 和实时目录比对，因此工具数量和价格不会悄然偏离。

工具	价格	提供的内容
get_overnight_risk_brief	$0.012	只需 $0.012 USDC，即可获取可直接用于决策的隔夜风险简报：DEX 与 CEX 价差、清算区域、资金费率预测、情绪、稳定币健康状况，以及自该钱包上次调用以来记录的变化。比单独购买五项内容便宜 20%（$0.015），且只需结算一次，而不是五次。
get_memecoin_risk	$0.005	只需 $0.005 USDC，即可获取 Solana 或 Base 上单个代币的 Memecoin 风险判定：LOW、ELEVATED、HIGH 或 CRITICAL，并列出判定依据——仅根据真实资产评估流动性、铸币和冻结权限、蜜罐和卖出税、流动性锁定、持币者集中度。数据源无法提供的信息会标记为未知，绝不会视为通过。每项判定都会作为一条声明存档，并在 7 天后于 /calibration 公开评分。
get_new_memecoins	$0.010	每 15 分钟筛选一次 Solana 或 Base 上的新 Memecoin 池（$0.010 USDC）：每个池均附带风险判定、筛选时的市场状况，以及其 7 天声明是否已得到验证。公开业绩记录即根据同一组对象计算。
try_crypto_prices	免费	免费样例，无需付款：实时 BTC 价格，供你判断格式和数据源。限速为每分钟 30 次请求。get_crypto_prices（$0.002 USDC）还会提供 ETH、SOL、BNB 和 XRP。响应会列出样例未提供的内容。
try_sentiment	免费	免费样例，无需付款：市场情绪中的恐惧与贪婪部分。限速为每分钟 30 次请求。get_sentiment 还会提供综合读数和基于资金费率的部分。响应会列出样例未提供的内容。
try_funding_rates	免费	免费样例，无需付款：BTC 永续合约资金费率。限速为每分钟 30 次请求。get_funding_rates（$0.002 USDC）覆盖所有受追踪的永续合约。响应会列出样例未提供的内容。
get_signal_history_7d	$0.005	获取已记录信号过去 7 天的数据，而不只是当前值。费用为 $0.005 USDC。每个已记录日期都锚定在 Base 上——可通过 /anchors?verify=YYYY-MM-DD 验证。
get_signal_history_30d	$0.012	获取已记录信号过去 30 天的数据。费用为 $0.012 USDC。与每个已记录日期一样，数据锚定在 Base 上。仅当这 30 天的数据通过就绪门槛（没有超过 6 小时的数据缺口）时才提供；否则服务会返回 404。
get_signal_history_full	$0.020	获取信号的完整记录序列。费用为 $0.020 USDC。与每个已记录日期一样，数据锚定在 Base 上。仅当整个序列通过就绪门槛（没有超过 6 小时的数据缺口）时才提供；否则服务会返回 404。
get_arbitrage_spread_history	$0.015	获取 30 天的跨交易所小时级价差（MEXC/Binance/Bybit/OKX）。费用为 $0.015 USDC。每个交易平台都会公布自己的价格，但没有人会存档它们之间的价差。仅当 30 天记录通过就绪门槛时才提供。
get_funding_accuracy	$0.015	获取我们的资金费率预测记录，并根据之后观察到的费率评分，覆盖 30 天。费用为 $0.015 USDC。购买 get_funding_predictions 前请先查看。仅当 30 天记录通过就绪门槛时才提供。
get_market_pulse	$0.018	只需 $0.018 USDC，即可将 8 项信号打包在一次调用和一次结算中：情绪、清算水平、波动率、相关性、资金费率预测、仓位、供应量、稳定币健康状况。单独购买需 $0.022，且要结算八次。
get_funding_predictions	$0.003	获取 MEXC 上 BTC/ETH/SOL 的下一期预测资金费率，以及距离结算的时间。费用为 $0.003 USDC。请先查看 get_signal_calibration——此信号会公开评分，目前平均误差尚未优于朴素基线。
get_positioning	$0.005	获取各交易平台的多空仓位比率。费用为 $0.005 USDC。
get_etf_flows	$0.005	获取以百万美元计的 BTC/ETH 现货 ETF 每日净流入，并附带 30 天历史数据。费用为 $0.005 USDC。
get_macro_onchain	$0.003	获取宏观链上指标。费用为 $0.003 USDC。
get_supply	$0.003	获取 18 种代币的流通供应量、总供应量和最大供应量，以及流通量与总量之比。在持续增发的情况下，低于 1 的比例意味着供应过剩。费用为 $0.003 USDC。
get_changes_since_last_call	$0.001	仅返回自此钱包上次付费获取某项信号以来的变化。费用为 $0.001 USDC，比任何完整数据载荷都便宜。服务端会按你的钱包保存游标，因此你无需重新下载或对比已持有的数据。首次调用会返回过去 24 小时的数据。
watch_condition	$0.010	注册一个持续生效的条件，由始终在线的服务端替你监控。费用为 $0.010 USDC，有效期最长为 168 小时。之后可免费轮询 watch_status，无需为重复的数据调用付费。
get_signal_calibration	免费	免费。了解此处的信号实际判断正确的频率，并与朴素基线进行比较评分。每条声明都会在结果出现前记录，并在事后根据已记录的序列评分。信任任何信号前，请先查看此项——包括了解哪些信号目前还不值得付费。
get_crypto_prices	$0.002	获取 BTC、ETH、SOL、BNB、XRP 的实时价格。费用为 $0.002 USDC。
get_funding_rates	$0.002	获取 BTC/ETH/SOL 永续期货资金费率及多空信号。费用为 $0.002 USDC。
get_market_overview	$0.003	获取完整市场概览，包括情绪倾向、套利检测和资金费率收益率。费用为 $0.003 USDC。
get_volatility	$0.002	获取 BTC/ETH/SOL 的 24 小时波动率、区间和年化波动率。费用为 $0.002 USDC。
get_liquidation_levels	$0.003	获取 BTC/ETH/SOL 按杠杆倍数（5x/10x/20x）估算的清算区域。费用为 $0.003 USDC。
get_correlation	$0.002	获取 30 天价格相关性矩阵（ETH/BTC、SOL/BTC、SOL/ETH）。费用为 $0.002 USDC。
get_gas_prices	$0.002	获取 Base、Ethereum、Solana 当前的 Gas 价格及美元成本估算。费用为 $0.002 USDC。
get_base_activity	$0.003	获取 Base 主网网络活动数据：TPS、区块统计、Gas 利用率。费用为 $0.003 USDC。
get_defi_yields	$0.003	获取 Aave、Compound、Morpho、Pendle 的热门 DeFi 收益机会（通过 DefiLlama）。费用为 $0.003 USDC。
get_arbitrage_opportunities	$0.005	获取 MEXC、Binance、Bybit、OKX 之间的跨交易所套利机会。费用为 $0.005 USDC。
get_dex_vs_cex	$0.005	获取 DEX 聚合价格与 CEX 价格的对比及 BTC/ETH/SOL 价差分析。费用为 $0.005 USDC。
get_technical_indicators	$0.003	获取指定交易对和时间间隔的 RSI、MACD、布林带、ATR。费用为 $0.003 USDC。
get_support_resistance	$0.005	通过 4 小时时间框架上的分形分析获取支撑位和阻力位。费用为 $0.005 USDC。
get_sentiment	$0.002	获取综合市场情绪：恐惧与贪婪指数、基于资金费率的情绪及综合评分。费用为 $0.002 USDC。
get_stablecoin_health	$0.002	获取稳定币锚定监控（USDC、DAI 实时脱锚检查）及按市值排名的前 10 种稳定币。费用为 $0.002 USDC。
get_historical	$0.010	获取用于回测的历史 OHLCV 蜡烛图数据。费用为 $0.010 USDC。
就绪门会在历史工具自身的记录足够深入、值得收费之前，暂不开放这些工具。发布前请运行 npm run check-catalogue，将此软件包与在线服务进行比对。

环境变量

变量	默认值	描述
AGENTDATA_BUYER_PRIVATE_KEY	—	用于自动付款的钱包（可选）
AGENTDATA_MAX_PAYMENT_USDC	0.05	单次调用自动付款上限
AGENTDATA_SESSION_BUDGET_USDC	1.00	每个进程的自动付款总支出上限
AGENTDATA_BASE_URL	https://agentdata-api.com	覆盖 API 基础 URL

单次调用上限本身并不能限制总支出——循环运行的 Agent 会在每次迭代时支付该金额。真正能阻止支出的是 AGENTDATA_SESSION_BUDGET_USDC：进程达到该支出金额后，后续付费调用会报错，而不会再签署授权。结算被拒不会产生费用，也不会计入此上限。

成本效益

get_overnight_risk_brief 将总计 $0.015 的五次调用合并为一次 $0.012 的结算。 get_market_pulse 以 $0.018 打包八项更广泛的信号，而单独购买则需 $0.022。 付费获取衍生信号前，应先查看免费的校准工具。

向买家钱包充值 $5 USDC → 足以进行约 2,500 次情绪检查，或 250 次完整历史调用。

买家钱包无需 ETH。AgentData 结算服务会支付结算 Gas 费。

相关项目

• agentdata-api — 底层服务
• elizaos-plugin-agentdata — ElizaOS 插件版本
• 在线服务： https://agentdata-api.com
• 管理控制面板： https://agentdata-api.com/admin

关键词

Model Context Protocol、MCP 服务、Claude Desktop MCP、Cursor MCP、加密货币市场数据 MCP、x402 MCP、AI Agent 工具、Agent 支付、USDC 小额支付、Base 主网 API、面向 AI 的 DeFi 数据、面向大模型的加密货币工具、自主 Agent 数据、Agent 经济、DeFAI

许可证

MIT — 参见 LICENSE。