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

已验证STDIO仅桌面网页搜索与抓取金融开发者工具

概览

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 分

    请在仓库或注册中心条目中声明许可证。