X402search Mcp

io.github.x402-index由 GitHub 帳號 x402-index 發布v1.0.2更新於 Oct 24, 2026

Search 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz

概覽

AI 產生的概覽

讓助理搜尋 13,000 多個支援 x402 的 HTTP API,回傳端點與付款中介資料,並按次以 USDC 付費。

可以做什麼
提供 search_x402_apis 工具,用來查詢支援 x402 的 HTTP API 索引。此工具接受查詢字串,以及選用的 network、max_price_usdc 與 limit 篩選條件,並回傳結構化結果,包括端點 URL、付款中介資料、網路與相關性排名。主要針對加密貨幣、DeFi 與區塊鏈 API 的探索查詢。
適用情境
當助理需要為某項任務尋找付費 HTTP API(尤其是加密貨幣、DeFi 或區塊鏈資料),並希望依網路或最高價格篩選結果時使用。它不是通用網頁搜尋工具,會拒絕無關的請求。如果不希望按次進行加密貨幣付款,則不建議使用。
執行需求
透過 npx(npm 套件 x402search-mcp)或 pip(PyPI 套件 x402search-mcp)在本機執行,需要 Node.js 或 Python。需要以環境變數 PRIVATE_KEY / EVM_PRIVATE_KEY 提供 EVM 錢包私鑰,並在 Base 主網(eip155:8453)上持有 USDC,以支付每次 0.01 USDC 的搜尋費用。需要連線至 x402search.xyz 的網路存取。不需要註冊帳號。
安裝前請注意
需要 EVM 私鑰(PRIVATE_KEY / EVM_PRIVATE_KEY)來簽署付款;錢包私鑰可控制資金,建議使用專用的低餘額錢包,不要用主錢包。每次搜尋花費 0.01 USDC(Base 主網),會產生實際支出。私鑰以明文形式放在環境變數或設定檔中。查詢內容與付款中介資料會傳送到 x402search.xyz 服務及其索引。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

x402search MCP Server

Search 14,000+ x402-enabled HTTP APIs from any MCP-compatible agent.

Version: 1.0.3 · License: MIT · Cost: $0.01 USDC per search · Base mainnet · No account needed

npm: https://www.npmjs.com/package/x402search-mcp
PyPI: https://pypi.org/project/x402search-mcp
API: https://x402search.xyz


Requirements


Install: Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "x402search": {      "command": "npx",      "args": ["[email protected]"],      "env": {        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"      }    }  }}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Install: Claude Code

bash
claude mcp add x402search -- npx [email protected]

Then set your key:

bash
export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

Install: Cursor

Add to .cursor/mcp.json:

json
{  "mcpServers": {    "x402search": {      "command": "npx",      "args": ["[email protected]"],      "env": {        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"      }    }  }}

Install: Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "x402search": {      "command": "npx",      "args": ["[email protected]"],      "env": {        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"      }    }  }}

Install: Python agents (LangChain, CrewAI, AutoGen, GAME SDK)

bash
pip install x402search-mcp
python
from x402search import search_x402_apisresults = search_x402_apis(    query="token price API ethereum",    private_key="0xYOUR_PRIVATE_KEY_HERE")print(results)

Full docs: https://pypi.org/project/x402search-mcp


Quick Test

bash
EVM_PRIVATE_KEY=0xYOUR_KEY npx [email protected]

Tool: search_x402_apis

ParameterTypeRequiredDescription
querystringyese.g. "token price API", "DEX swap routing"
networkstringnoe.g. "eip155:8453" for Base mainnet
max_price_usdcnumbernoFilter to APIs at or below this price
limitnumbernoMax results (default 10, max 50)

Virtuals ACP Integration

x402search is available as a native ACP agent on the Virtuals protocol marketplace.

  • Agent ID: 22531
  • Agent profile: https://app.virtuals.io/acp/agent-details/22531
  • Job name: x402search
  • Price: 0.01 USDC per search
  • Accepts crypto, DeFi, and blockchain API discovery queries
  • Rejects off-topic requests automatically at the request phase
  • Returns structured results: endpoint URLs, payment metadata, network, and relevance rank

Links

來源:README.md,提交 e0c4d45

工具

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

版本歷史

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

評分

已滿足適用檢查項的 40%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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

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