English Français العربية

io.github.x402-index/x402search-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package x402search-mcp
Claude Code 
claude mcp add x402search-mcp -e 'PRIVATE_KEY=<your private_key>' -- npx -y x402search-mcp@1.0.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "x402search-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "x402search-mcp@1.0.2"
            ],
            "env": {
                "PRIVATE_KEY": "<your private_key>"
            }
        }
    }
}

متغيرات البيئة

  • PRIVATE_KEY إلزامي سري EVM private key for x402 payment signing

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. x402search MCP Server
  2. Requirements
  3. Install: Claude Desktop
  4. Install: Claude Code
  5. Install: Cursor
  6. Install: Windsurf
  7. Install: Python agents (LangChain, CrewAI, AutoGen, GAME SDK)
  8. Quick Test
  9. Tool: search_x402_apis
  10. Virtuals ACP Integration
  11. Links

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:

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["x402search-mcp@1.0.3"],
      "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

claude mcp add x402search -- npx x402search-mcp@1.0.3

Then set your key:

export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE

Install: Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["x402search-mcp@1.0.3"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

Install: Windsurf

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

{
  "mcpServers": {
    "x402search": {
      "command": "npx",
      "args": ["x402search-mcp@1.0.3"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

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

pip install x402search-mcp
from x402search import search_x402_apis
results = 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

EVM_PRIVATE_KEY=0xYOUR_KEY npx x402search-mcp@1.0.3

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

الأسئلة الشائعة

ما هو io.github.x402-index/x402search-mcp؟

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

كيف أثبّت io.github.x402-index/x402search-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add x402search-mcp -e 'PRIVATE_KEY=<your private_key>' -- npx -y x402search-mcp@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.x402-index/x402search-mcp إلى مفتاح API؟

نعم. يتطلب PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.x402-index/x402search-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.x402-index/x402search-mcp؟

ينشره x402-index. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.