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_priceget_crypto_marketsget_trending_crypto,获取实时代币和市场信息。
  • 搜索航班和酒店 — 使用 search_flightssearch_hotelssearch_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_servicesservice_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_NETWORKautoautobasesolana
X402_MAX_PAYMENT_USD1.00每次请求的硬性支出上限
X402_BASE_URL生产网关覆盖网关 URL
X402_PAYMENT_HEADER未设置旧版预签名 x402 头
X402_DEV_BYPASS未设置开发环境绕过密钥

auto 模式下,当两个密钥都配置时,优先使用 Base。自动支付仅接受 Base 和 Solana 上的规范 USDC 合约。在签署前,它会拒绝未知资产、不支持的链以及超过配置上限的金额。

MegaETH 仍可供自行提供兼容支付头的客户端使用。

MCP 工具

类别工具
发现discover_servicesservice_health
图像与代码generate_imageexecute_code
音频transcribe_audio
加密货币get_crypto_priceget_crypto_marketsget_crypto_historyget_trending_cryptosearch_cryptoget_crypto_categories
钱包与代币get_wallet_balancesget_wallet_transactionsget_wallet_pnlget_token_pricesget_token_metadata
IPFSpin_to_ipfsget_from_ipfs
旅行search_flightssearch_locationssearch_hotelssearch_cheapest_dates

价格包含在每个工具描述和实时发现中。网关目录可独立于此包进行更改。

发现

开发

npm install
npm test
npm run build

链接