X402 API MCP Server

@x402 api/mcp服务器

MCP服务器，允许Claude、ChatGPT和任何与MCP兼容的AI代理通过 x402协议.

8个工具。没有API密钥。AI代理根据请求在Base上支付USDC小额付款。

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

工具

______________________________________________________________________

快速开始

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

只需运行它——任何402个响应都将返回人类可读的支付指令：

npx @x402-api/mcp-server

当工具需要付款时，克劳德会告诉你需要什么。

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

安装可选的支付deps并设置您的钱包密钥：

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

服务器将在Base上使用USDC自动支付402个响应。 确保你的钱包在Base主网上有USDC。

______________________________________________________________________

Claude桌面集成

添加到您的 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"
      }
    }
  }
}

配置文件位置：

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

______________________________________________________________________

环境变量

______________________________________________________________________

x402付款方式

此API使用 x402协议 --需要HTTP 402付款：

1. 代理呼叫工具 → MCP服务器发出API请求
2. 服务器返回402 付款详细信息（金额、USDC地址、基础网络）
3. 自动支付模式： x402获取签名并提交付款，自动重试请求
4. 手动模式： MCP返回402详细信息，以便用户/代理可以安排付款

付款详情：

• 代币：Base主网上的USDC
• 地址： 0x60264c480b67adb557efEd22Cf0e7ceA792DefB7
• 链条：底座（链条ID 8453）
• 金额：每次通话0.001-0.008美元（\<1美分美元）

______________________________________________________________________

工具参考

get_crypto_prices

没有参数。返回BTC、ETH、SOL+前24小时移动者的当前价格。

Cost: 0.001 USDC

get_gas_prices

没有参数。返回以太坊、Base、Polygon、Arbitrum（慢速/标准/快速层）的天然气价格。

Cost: 0.001 USDC

get_dex_quotes

比较DEX之间的掉期报价。

Cost: 0.002 USDC

scan_token

令牌安全扫描——检测地毯拉旗、蜜罐模式、铸币局等。

Cost: 0.003 USDC

track_whales

鲸鱼追踪——持有者集中度、基尼系数、最近的大幅变动。

Cost: 0.005 USDC

scan_yields

顶级DeFi在Aave、Compound、Morpho、Lido、Pendle等地都有机会。

Cost: 0.005 USDC

get_funding_rates

币安、OKX、Bybit、dYdX、GMX、Hyperliquit的永久融资利率。

Cost: 0.008 USDC

profile_wallet

完整的钱包投资组合分析——持有量、DeFi头寸、活动、PnL、风险评分。

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协议
• 基础链
• ERC-8004代理身份
• BaseScan上的代理#18763

______________________________________________________________________

许可证

麻省理工学院