X402engine Mcp

io.github.agentc22由 GitHub 帳號 agentc22 發布v1.0.3更新於 Nov 3, 2026

50+ pay-per-call APIs for AI agents — images, LLM, code, crypto, travel & more via x402

已驗證STDIO僅桌面網頁搜尋與抓取金融AI 與機器學習

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理探索並呼叫 50 多個按次付費的 API，透過 x402 在 Base 或 Solana 上以 USDC 自動付款。

可以做什麼
  • 免費探索閘道服務目錄並檢查服務健康狀態
  • 產生圖片並執行程式碼
  • 轉錄音訊
  • 查詢加密貨幣價格、行情、歷史、熱門幣種、分類與搜尋
  • 讀取錢包餘額、交易與損益，以及代幣價格和中繼資料
  • 在 IPFS 上釘選與讀取檔案，並搜尋航班、地點、飯店與最便宜旅遊日期
適用情境
適合需要從同一個閘道取得多種不相關能力（圖像、LLM、程式碼、加密、旅遊、IPFS），且願意按次以 USDC 付費的情境。免費的探索與健康檢查工具不需錢包即可使用，也可先拿來瀏覽目錄。
執行需求
透過 npx 在本機執行（需 Node.js）。付費工具需要已儲值的付款錢包：Base USDC 用 X402_EVM_PRIVATE_KEY，Solana USDC 用 X402_SOLANA_PRIVATE_KEY，Solana 另需 SOL 支付手續費。選用設定包括 X402_PAYMENT_NETWORK、X402_MAX_PAYMENT_USD、X402_BASE_URL、X402_PAYMENT_HEADER 與 X402_DEV_BYPASS。需要可連線至閘道的網路。
安裝前請注意
付費工具會從設定的錢包實際花費 USDC；X402_MAX_PAYMENT_USD 的上限是依單次請求計算，而非依任務，應為每個任務另外設定預算。請使用專用的低餘額錢包，切勿在對話中放入私鑰。X402_DEV_BYPASS 會略過付款，X402_PAYMENT_HEADER 則帶有預先簽署的付款標頭。請求會送往第三方閘道，其目錄可能與本套件各自獨立變動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 X402engine Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

x402engine-mcp

Agent-friendly MCP server for x402engine. It lets agents discover and call pay-per-request APIs through HTTP 402, with automatic USDC payment on Base or Solana.

The live gateway covers LLMs, image and video generation, web search and scraping, code execution, crypto and wallet data, transaction simulation, audio, travel, and IPFS. This MCP exposes a curated tool set and live discovery for the full catalog.

Quick Start

Use a dedicated, low-balance payer wallet. The MCP signs x402 payments locally and never sends the private key to x402engine.

Base

json
{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",        "X402_PAYMENT_NETWORK": "base",        "X402_MAX_PAYMENT_USD": "1.00"      }    }  }}

Fund the wallet with USDC on Base. The x402 facilitator pays transaction gas; the wallet signs an EIP-3009 USDC authorization.

Solana

json
{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",        "X402_PAYMENT_NETWORK": "solana",        "X402_MAX_PAYMENT_USD": "1.00"      }    }  }}

Fund the wallet with USDC on Solana and enough SOL for transaction fees.

Discovery Without a Wallet

The server starts without a wallet, and free tools such as discover_services and service_health still work. Paid tools return their x402 payment requirements until a wallet is configured.

bash
claude mcp add x402engine -- npx -y [email protected]

Hermes Agent

Install the x402engine skill and merge this server into the active Hermes profile's config.yaml:

yaml
mcp_servers:  x402engine:    command: npx    args: ["-y", "[email protected]"]    env:      X402_BASE_URL: "https://x402engine.app"      X402_PAYMENT_NETWORK: "auto"      X402_MAX_PAYMENT_USD: "0.10"

Start a new session and call discover_services or service_health; both are free. Keep the network on auto until a wallet is configured. For Base payments, store X402_EVM_PRIVATE_KEY in the profile's local .env, add X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" to the server's env, and change the network to base. Never put wallet keys in chat. The cap applies per request; authorize a separate total budget for each task.

Full Hermes setup guide · Installable skill

Payment Controls

VariableDefaultDescription
X402_EVM_PRIVATE_KEYunsetDedicated payer key for Base USDC
X402_SOLANA_PRIVATE_KEYunsetBase58 or JSON payer key for Solana USDC
X402_PAYMENT_NETWORKautoauto, base, or solana
X402_MAX_PAYMENT_USD1.00Hard per-request spending limit
X402_BASE_URLproduction gatewayOverride the gateway URL
X402_PAYMENT_HEADERunsetLegacy pre-signed x402 header
X402_DEV_BYPASSunsetDevelopment bypass secret

In auto mode, Base is preferred when both keys are configured. Automatic payment only accepts the canonical USDC contracts on Base and Solana. It rejects unknown assets, unsupported networks, and amounts above the configured cap before signing.

MegaETH remains available to clients that supply their own compatible payment header.

MCP Tools

CategoryTools
Discoverydiscover_services, service_health
Image and codegenerate_image, execute_code
Audiotranscribe_audio
Cryptoget_crypto_price, get_crypto_markets, get_crypto_history, get_trending_crypto, search_crypto, get_crypto_categories
Wallet and tokenget_wallet_balances, get_wallet_transactions, get_wallet_pnl, get_token_prices, get_token_metadata
IPFSpin_to_ipfs, get_from_ipfs
Travelsearch_flights, search_locations, search_hotels, search_cheapest_dates

Prices are included in each tool description and in live discovery. The gateway catalog can change independently of this package.

Discovery

Development

bash
npm installnpm testnpm run build

Links

來源：README.md，提交 dd1c274

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.3最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。