x402engine

官方

50多个按次付费的API，供AI代理通过HTTP 402加密微支付使用。每次调用费用为0.001–0.12美元，支持USDC和USDm支付。

GitHub
1

你可以用 x402engine MCP 做什么？

  • 发现付费 API — 让您的助手通过 discover_services 列出可用的按请求付费服务，并使用 service_health 检查其状态。
  • 生成图像并运行代码 — 使用 generate_image 请求图像创建，或使用 execute_code 执行代码，并自动通过 Base 或 Solana 进行 USDC 支付。
  • 查询加密货币和钱包数据 — 使用 get_crypto_price 和 get_wallet_balances 等工具获取价格、市场趋势、钱包余额、交易和代币元数据。
  • 处理音频和 IPFS — 使用 transcribe_audio 转录音频文件，或使用 pin_to_ipfs 和 get_from_ipfs 在 IPFS 上固定和检索内容。
  • 搜索旅行选项 — 使用 search_flights 和 search_hotels 等工具查找航班、酒店、地点和最便宜的旅行日期。

文档

x402engine-mcp

面向智能体的 MCP 服务器，用于 x402engine。它让智能体能够通过 HTTP 402 发现并调用按请求付费的 API，并在 Base 或 Solana 上自动完成 USDC 支付。

实时网关涵盖 LLM、图像和视频生成、网络搜索与抓取、代码执行、加密货币和钱包数据、交易模拟、音频、旅行以及 IPFS。此 MCP 提供精选工具集和完整目录的实时发现功能。

快速开始

使用专用的、低余额的付款钱包。MCP 在本地签署 x402 支付，绝不会将私钥发送给 x402engine。

Base

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.1"],
      "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.1"],
      "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.1

Hermes 智能体

安装 x402engine 技能，并将此服务器合并到活动 Hermes 配置文件的 config.yaml 中：

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "x402engine-mcp@1.1.1"]
    env:
      X402_BASE_URL: "https://x402engine.app"
      X402_PAYMENT_NETWORK: "auto"
      X402_MAX_PAYMENT_USD: "0.10"

启动新会话并调用 discover_services 或 service_health；两者均免费。在配置钱包之前，保持网络为 auto。对于 Base 支付，将 X402_EVM_PRIVATE_KEY 存储在配置文件的本地 .env 中，将 X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" 添加到服务器的 env，并将网络更改为 base。切勿在聊天中放置钱包密钥。上限适用于每个请求；为每个任务单独授权总预算。

完整 Hermes 设置指南 · 可安装技能

支付控制

变量默认值描述
X402_EVM_PRIVATE_KEY未设置用于 Base USDC 的专用付款密钥
X402_SOLANA_PRIVATE_KEY未设置用于 Solana USDC 的 Base58 或 JSON 付款密钥
X402_PAYMENT_NETWORKautoauto、base 或 solana
X402_MAX_PAYMENT_USD1.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
IPFSpin_to_ipfs、get_from_ipfs
旅行search_flights、search_locations、search_hotels、search_cheapest_dates

价格包含在每个工具描述和实时发现中。网关目录可能独立于此包发生变化。

发现

开发

npm install
npm test
npm run build

链接