x402-api

@x402-api/mcp-server

MCP 服务可通过 x402 protocol，让 Claude、ChatGPT 和任何兼容 MCP 的 AI Agent 使用按次付费的加密货币/DeFi 数据。

8 个工具。无需 API 密钥。AI Agent 每次请求通过 Base 支付 USDC 微支付。

查找此服务： Official MCP Registry · Glama · Agent discovery manifest · OpenAPI。

  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
    ╚███╔╝ ███████║██║   ██║ █████╔╝
    ██╔██╗ ╚════██║██║   ██║██╔═══╝
   ██╔╝ ██╗     ██║╚██████╔╝███████╗
   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

工具

工具	API 端点	费用	描述
get_crypto_prices	GET /api/price-feed	0.001 USDC	BTC/ETH/SOL + 24 小时涨幅最高的币种
get_gas_prices	GET /api/gas-tracker	0.001 USDC	多链 Gas 价格（ETH、Base、Polygon、Arbitrum）
get_dex_quotes	GET /api/dex-quotes	0.002 USDC	一条 ParaSwap 聚合路由
scan_token	GET /api/token-scanner	0.003 USDC	GoPlus 安全标记和启发式分析
track_whales	GET /api/whale-tracker	0.005 USDC	最大持有者抽样和供应量占比
scan_yields	GET /api/yield-scanner	0.005 USDC	DefiLlama 池的 APY 和 TVL
get_funding_rates	GET /api/funding-rates	0.008 USDC	Hyperliquid 和 dYdX 每小时费率
profile_wallet	GET /api/wallet-profiler	0.008 USDC	已观测的 Blockscout 余额；覆盖范围有限

---

快速开始

选项 A：检查模式（无需付款）

直接运行即可——任何 402 响应都会返回易于理解的付款说明：

npx @x402-api/mcp-server

工具需要付款时，Claude 会告知你所需的信息。

选项 B：自动付款模式（完全自主）

安装可选的付款依赖项并设置钱包密钥：

npm install -g @x402-api/mcp-server
npm install -g viem
export X402_WALLET_PRIVATE_KEY=0x<your_private_key>
x402-api-mcp

只有当 API 声明支持该结算模式时，MCP 服务才会签署 Base USDC EIP-3009 授权。每次调用的默认付款上限为 0.01 USDC。请在 Base 上为钱包充值 USDC；在直接结算模式下，API 运营方会承担 Gas 费用。

---

Claude Desktop 集成

将以下内容添加到 claude_desktop_config.json：

不启用自动付款（检查模式）

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"]
    }
  }
}

启用自动付款

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"],
      "env": {
        "X402_WALLET_PRIVATE_KEY": "0x<your_private_key>"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

---

环境变量

变量	必填	描述
X402_WALLET_PRIVATE_KEY	可选	用于 EIP-3009 自动付款的 Base 钱包私钥。需要 viem。
X402_MAX_PER_CALL_USDC	可选	每次调用的上限，默认为 0.01 USDC。
X402_API_BASE_URL	可选	覆盖 API URL（默认值：https://x402-api.fly.dev）

---

x402 付款方式

此 API 使用 x402 protocol——HTTP 402 Payment Required：

1. Agent 调用工具 → MCP 服务发起 API 请求
2. 服务返回 402，并附上付款详情（金额、USDC 地址、Base 网络）
3. 自动付款模式： 此客户端签署 EIP-3009 授权并重试；API 在 Base 上完成结算
4. 检查模式： MCP 返回 402 详情，但不会签署或付款

付款详情：

• 代币：Base 主网上的 USDC
• 地址：0x60264c480b67adb557efEd22Cf0e7ceA792DefB7
• 链：Base（chain ID 8453）
• 金额：每次调用 0.001–0.008 USDC（不到 1 美分）

---

工具参考

get_crypto_prices

无需参数。返回 BTC、ETH、SOL 的当前价格，以及 24 小时涨幅最高的币种。

Cost: 0.001 USDC

get_gas_prices

无需参数。返回 Ethereum、Base、Polygon、Arbitrum 的 Gas 价格，分为慢速/标准/快速等级。

Cost: 0.001 USDC

get_dex_quotes

获取一条 ParaSwap 聚合路由。不对各 DEX 平台进行独立比较。

参数	类型	必填	说明
from	string	✅	输入代币（例如 "ETH"、"0x..."）
to	string	✅	输出代币（例如 "USDC"）
amount	string	✅	兑换数量（例如 "1.5"）

Cost: 0.002 USDC

scan_token

代币安全扫描——检测 Rug Pull 标记、蜜罐模式、铸币权限等。

参数	类型	必填	说明
token	string	✅	合约地址或代币符号（例如 "PEPE"）

Cost: 0.003 USDC

track_whales

来自 GoPlus 的头部持有者样本。无法获取 Gini 系数和近期转账历史。

参数	类型	必填	说明
token	string	✅	合约地址或代币符号

Cost: 0.005 USDC

scan_yields

涵盖 Aave、Compound、Morpho、Lido、Pendle 等平台的顶级 DeFi 收益机会。

参数	类型	必填	说明
chain	string	❌	按链筛选："ethereum"、"base"、"arbitrum"、"polygon"
min_tvl	number	❌	最低 TVL（美元），例如 1000000

Cost: 0.005 USDC

get_funding_rates

来自 Hyperliquid 和 dYdX v4 的每小时永续合约资金费率。价差仅供参考。

参数	类型	必填	说明
asset	string	❌	资产符号（例如 "BTC"、"ETH"）。省略时返回所有资产。

Cost: 0.008 USDC

profile_wallet

已观测到的带价格钱包余额和可用交易次数。无法获取 DeFi 仓位、PnL 和风险评分。

参数	类型	必填	说明
address	string	✅	Ethereum/Base 钱包地址（0x...）

Cost: 0.008 USDC

---

开发

git clone https://github.com/fernsugi/x402-api-mcp-server
cd x402-api-mcp-server

npm install
npm run build
npm start

如需在没有付款钱包的情况下测试，只需运行并查看 402 响应：

node dist/index.js

---

链接

• x402 API 落地页
• x402 协议
• Base 链
• ERC-8004 Agent 身份
• BaseScan 上的 Agent #18763

---

许可证

MIT

三个可运行的工作流

工作流	工具	USDC 总额
代币检查	scan_token + track_whales	0.008
ETH 资金费率	get_funding_rates	0.008
兑换报价 + Gas	get_dex_quotes + get_gas_prices	0.003

可运行的 Node 示例以检查模式启动。每个演示都包含输入、记录的提供方输出、覆盖范围限制、支出上限和 Agent 提示词。

可选的 X402_REFERRAL_SOURCE 用于标记请求，以便进行第一方汇总归因（默认值为 mcp）。这只是提示，不会验证调用方身份。API 不记录原始付款方钱包、IP 地址或签名。默认情况下，X402_EXPECTED_PAY_TO 会将付款接收方固定为官方钱包。工具会提示自动付款可能产生费用，重复调用可能再次收费。

Cursor / 其他本地 MCP 客户端

使用上方所示的相同 mcpServers 配置。对于 Cursor，请将其放在项目中的 .cursor/mcp.json。检查模式无需钱包。启用自动付款前，请设置 X402_MAX_PER_CALL_USDC；重复调用会再次产生支出。请将钱包凭据保存在本地环境设置中，不要放入 Git。

注册表发布

Publish MCP Registry GitHub 工作流会验证匹配的 npm 版本，然后使用 GitHub OIDC 发布 server.json。该工作流会在 GitHub 版本发布后运行，或在从 main 分支手动触发时运行。CI 中不会存储 npm token、GitHub PAT 或钱包密钥。Actions 和官方发布者源代码均固定到已验证的提交。创建版本之前，仍需单独发布到 npm。