X402search Mcp

io.github.x402-indexPublished by GitHub account x402-indexv1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceDeveloper Tools

Overview

AI-generated overview

Lets an assistant search a catalog of 13,000+ x402-enabled HTTP APIs and return endpoints with payment metadata, paying per search in USDC.

What you can do
Exposes a search_x402_apis tool that queries an index of x402-enabled HTTP APIs. The tool accepts a query string plus optional network, max_price_usdc and limit filters, and returns structured results such as endpoint URLs, payment metadata, network and relevance rank. It is aimed at crypto, DeFi and blockchain API discovery queries.
When to use it
Use it when an agent needs to find a paid HTTP API for a task, especially crypto, DeFi or blockchain data, and you want results filtered by network or maximum price. It is not a general web search tool and rejects off-topic requests. Skip it if you do not want per-search crypto payments.
Requirements
Runs locally via npx (npm package x402search-mcp) or pip (PyPI package x402search-mcp); Node.js or Python is needed. Requires an EVM wallet private key supplied as the PRIVATE_KEY / EVM_PRIVATE_KEY environment variable, and USDC on Base mainnet (eip155:8453) to pay $0.01 USDC per search. Network access to x402search.xyz is required. No account is needed.
Before you install
Requires an EVM private key (PRIVATE_KEY / EVM_PRIVATE_KEY) that signs payments; a wallet key controls funds, so use a dedicated low-balance wallet rather than a main one. Each search costs $0.01 USDC on Base mainnet, so usage spends real money. The key is passed in plain environment variables or config files. Queries and payment metadata go to the x402search.xyz service and its index.

Installation

In SourceWeft

  1. Open X402search Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit e0c4d45

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.