x402engine

官方

50多個按次付費API，供AI代理透過HTTP 402加密小額支付使用。每次呼叫費用為0.001至0.12美元，支援USDC和USDm。

GitHub

你可以用 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 協調器會支付交易手續費；錢包則簽署 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_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

連結