x402engine
官方50多个按次付费的API,供AI代理通过HTTP 402加密微支付使用。每次调用费用为0.001–0.12美元,支持USDC和USDm支付。
你可以用 x402engine MCP 做什么?
- 发现可用的付费API — 通过
discover_services浏览实时网关目录,查找LLM、图像、加密货币、旅行及其他按次付费的端点。 - 付费前检查服务健康状态 — 使用
service_health验证端点是否可达,并查看当前定价,无需花费。 - 按需生成图像 — 调用
generate_image创建AI生成的图像,并通过Base或Solana自动完成USDC支付。 - 在沙盒中执行代码 — 通过
execute_code运行代码片段,并通过x402协议按执行次数付费。 - 获取加密货币价格和市场数据 — 查询
get_crypto_price、get_crypto_markets或get_trending_crypto,获取实时代币和市场信息。 - 搜索航班和酒店 — 使用
search_flights、search_hotels或search_locations查找旅行选项,按请求计费。
文档
x402engine-mcp
面向 x402engine 的智能体友好型 MCP 服务器。它允许智能体通过 HTTP 402 发现并调用按请求付费的 API,并在 Base 或 Solana 上自动完成 USDC 支付。
实时网关涵盖 LLM、图像与视频生成、网页搜索与抓取、代码执行、加密货币与钱包数据、交易模拟、音频、旅行以及 IPFS。此 MCP 提供了一套精选工具集,并支持对整个目录进行实时发现。
快速开始
请使用一个专用的、余额较低的钱包进行支付。MCP 在本地签署 x402 支付,绝不会将私钥发送给 x402engine。
Base
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.0"],
"env": {
"X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
"X402_PAYMENT_NETWORK": "base",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}
请为该钱包充值 Base 上的 USDC。x402 服务商支付交易 gas 费;钱包签署 EIP-3009 USDC 授权。
Solana
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.0"],
"env": {
"X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
"X402_PAYMENT_NETWORK": "solana",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}
请为该钱包充值 Solana 上的 USDC 以及足够的 SOL 用于支付交易费。
无钱包发现
服务器可在无钱包的情况下启动,此时 discover_services 和 service_health 等免费工具仍可正常工作。付费工具会返回其 x402 支付要求,直到配置钱包为止。
claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0
支付控制
| 变量 | 默认值 | 描述 |
|---|---|---|
X402_EVM_PRIVATE_KEY | 未设置 | 用于 Base USDC 的专用支付密钥 |
X402_SOLANA_PRIVATE_KEY | 未设置 | 用于 Solana USDC 的 Base58 或 JSON 支付密钥 |
X402_PAYMENT_NETWORK | auto | auto、base 或 solana |
X402_MAX_PAYMENT_USD | 1.00 | 每次请求的硬性支出上限 |
X402_BASE_URL | 生产网关 | 覆盖网关 URL |
X402_PAYMENT_HEADER | 未设置 | 旧版预签名 x402 头 |
X402_DEV_BYPASS | 未设置 | 开发环境绕过密钥 |
在 auto 模式下,当两个密钥都配置时,优先使用 Base。自动支付仅接受 Base 和 Solana 上的规范 USDC 合约。在签署前,它会拒绝未知资产、不支持的链以及超过配置上限的金额。
MegaETH 仍可供自行提供兼容支付头的客户端使用。
MCP 工具
| 类别 | 工具 |
|---|---|
| 发现 | discover_services、service_health |
| 图像与代码 | generate_image、execute_code |
| 音频 | transcribe_audio |
| 加密货币 | get_crypto_price、get_crypto_markets、get_crypto_history、get_trending_crypto、search_crypto、get_crypto_categories |
| 钱包与代币 | get_wallet_balances、get_wallet_transactions、get_wallet_pnl、get_token_prices、get_token_metadata |
| IPFS | pin_to_ipfs、get_from_ipfs |
| 旅行 | search_flights、search_locations、search_hotels、search_cheapest_dates |
价格包含在每个工具描述和实时发现中。网关目录可独立于此包进行更改。
发现
- 网关发现:.well-known/x402.json
- 智能体卡片:.well-known/agent.json
- 端点清单:.well-known/agent-manifest.v1.json
- 服务 API:/api/services
- 包元数据:server.json
开发
npm install
npm test
npm run build
链接
- 网站:x402engine.app
- npm:x402engine-mcp
- GitHub:agentc22/x402engine-mcp
- 协议:x402.org