@x402 api/mcp服务器
MCP服务器，允许Claude、ChatGPT和任何与MCP兼容的AI代理通过 x402协议.
8个工具。没有API密钥。AI代理根据请求在Base上支付USDC小额付款。
██╗ ██╗██╗ ██╗ ██████╗ ██████╗
╚██╗██╔╝██║ ██║██╔═══██╗╚════██╗
╚███╔╝ ███████║██║ ██║ █████╔╝
██╔██╗ ╚════██║██║ ██║██╔═══╝
██╔╝ ██╗ ██║╚██████╔╝███████╗
╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝工具
| 工具 | API端点 | 成本 | 描述 |
|---|---|---|---|
get_crypto_prices | GET /api/price-feed | 0.001 USDC | BTC/ETH/SOL+24小时热门交易者 |
get_gas_prices | GET /api/gas-tracker | 0.001美元 | 多链天然气（ETH、Base、Polygon、Arbitrum） |
get_dex_quotes | GET /api/dex-quotes | 0.002 USDC | 掉期报价：Uniswap、SushiSwap、1英寸 |
scan_token | GET /api/token-scanner | 0.003 USDC | 代币安全扫描+地毯拉取检测 |
track_whales | GET /api/whale-tracker | 0.005美元 | 持有人浓度+鲸鱼警报 |
scan_yields | GET /api/yield-scanner | 0.005美元 | DeFi收益率：Aave、Compound、Morpho、Lido、Pendle |
get_funding_rates | GET /api/funding-rates | 0.008 USDC | 6个场馆的Perp资助率 |
profile_wallet | GET /api/wallet-profiler | 0.008美元 | 完整的钱包投资组合+风险状况 |
______________________________________________________________________
快速开始
选项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_WALLET_PRIVATE_KEY | 可选 | 自动支付的私钥（例如。 0x...).如果设置，x402 fetch将自动处理付款。 |
X402_API_BASE_URL | 可选 | 覆盖API URL（默认值： https://x402-api.fly.dev) |
______________________________________________________________________
x402付款方式
此API使用 x402协议 --需要HTTP 402付款：
- 代理呼叫工具 → MCP服务器发出API请求
- 服务器返回402 付款详细信息（金额、USDC地址、基础网络）
- 自动支付模式： x402获取签名并提交付款，自动重试请求
- 手动模式： MCP返回402详细信息，以便用户/代理可以安排付款
付款详情：
- 代币：Base主网上的USDC
- 地址：
0x60264c480b67adb557efEd22Cf0e7ceA792DefB7 - 链条：底座（链条ID 8453）
- 金额：每次通话0.001-0.008美元（\<1美分美元）
______________________________________________________________________
工具参考
get_crypto_prices
没有参数。返回BTC、ETH、SOL+前24小时移动者的当前价格。
Cost: 0.001 USDCget_gas_prices
没有参数。返回以太坊、Base、Polygon、Arbitrum（慢速/标准/快速层）的天然气价格。
Cost: 0.001 USDCget_dex_quotes
比较DEX之间的掉期报价。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
from | string | ✅ | 输入令牌（例如。 "ETH", "0x...") |
to | string | ✅ | 输出令牌（例如。 "USDC") |
amount | string | ✅ | 交换金额（例如。 "1.5") |
Cost: 0.002 USDCscan_token
令牌安全扫描——检测地毯拉旗、蜜罐模式、铸币局等。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | ✅ | 合同地址或符号（例如。 "PEPE") |
Cost: 0.003 USDCtrack_whales
鲸鱼追踪——持有者集中度、基尼系数、最近的大幅变动。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
token | string | ✅ | 合同地址或符号 |
Cost: 0.005 USDCscan_yields
顶级DeFi在Aave、Compound、Morpho、Lido、Pendle等地都有机会。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
chain | string | ❌ | 按链过滤： "ethereum", "base", "arbitrum", "polygon" |
min_tvl | 编号 | ❌ | 最低TVL（美元）（例如。 1000000) |
Cost: 0.005 USDCget_funding_rates
币安、OKX、Bybit、dYdX、GMX、Hyperliquit的永久融资利率。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
asset | string | ❌ | 资产符号（例如。 "BTC", "ETH").所有资产如果省略。 |
Cost: 0.008 USDCprofile_wallet
完整的钱包投资组合分析——持有量、DeFi头寸、活动、PnL、风险评分。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | string | ✅ | 以太坊/基础钱包地址(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______________________________________________________________________
链接
______________________________________________________________________
许可证
麻省理工学院