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

適用於代理程式的 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.1"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

在 Base 上為錢包注入 USDC 資金。x402 facilitator 會支付交易 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 skill，並將此伺服器合併到作用中 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 付款，請在設定檔的本機 .env 中儲存 X402_EVM_PRIVATE_KEY，將 X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" 加入伺服器的 env，並將網路變更為 base。切勿在聊天中放入錢包金鑰。上限適用於每個請求；請為每個任務授權單獨的總預算。

完整 Hermes 設定指南 · 可安裝的 skill

付款控制

變數預設值說明
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

連結