# x402 Discovery API

> Search 2,400 verified x402 APIs. Broker lets you call any of them with one API key.

Base URL: https://discovery.hugen.tokyo

## Search APIs — Free (no payment required)

Find x402 APIs by keyword. Returns URL, description, price, quality score, brokerable flag.

- GET /discovery/search?q={keywords}
- GET /discovery/search?q={keywords}&category={category}
- GET /discovery/search?q={keywords}&limit={1-20}

## REST Broker — Call Any x402 API ($0.01/call)

One API key, 2,400+ APIs. No per-API wallet integration needed.

Setup:
  1. POST /keys/create → free key with $0.05 credit (5 broker calls; search is free)
  2. POST /keys/topup?key=gw_xxx → $1.00 x402 payment adds 100 broker calls

Usage:
  POST /broker/call
  Header: X-API-Key: gw_xxx
  Body: {"url": "https://weather.hugen.tokyo/weather/current?city=Tokyo", "method": "GET"}
  → Returns upstream API response directly (cost/balance in X-Broker-Cost, X-Broker-Balance headers)

## API Key Management

- POST /keys/create — Free key with $0.05 credit (broker; search is free)
- GET /keys/balance?key=gw_xxx — Check balance
- POST /keys/topup?key=gw_xxx — Add $1.00 balance, unlocks broker (x402 payment)

## MCP Gateway (for MCP-capable agents)

58 tools, one endpoint. Covers DeFi, Weather, Security, Domain, Intel, and more.

URL: https://mcp.hugen.tokyo/mcp
Transport: Streamable HTTP
Auth: Pass API key via _meta['api_key'] in tool calls

### Configuration examples

Claude Desktop / Cursor / VS Code:
{"mcpServers": {"x402-gateway": {"type": "remote", "url": "https://mcp.hugen.tokyo/mcp"}}}

LangChain:
async with MultiServerMCPClient({"x402": {"transport": "http", "url": "https://mcp.hugen.tokyo/mcp"}}) as client:
    tools = client.get_tools()

## Python SDK (for application developers)

pip install x402-pay

```python
import x402_pay
r = x402_pay.get("https://weather.hugen.tokyo/weather/current?city=Tokyo")
print(r.json())
```

First call auto-provisions a free API key ($0.05 broker credit; search is free).
After topup ($1.00), broker access unlocks — call any of 2,400+ APIs via one key.
Docs: https://github.com/hugen-tokyo/x402-pay

## 24 Categories

AI/LLM, Analytics, Bridge/Cross-chain, Code/Dev, Content, DeFi, Domain, Finance/FX, Governance, Identity/ENS, Image/Media, Intelligence, NFT, News, Other, Price/Market, Search/Discovery, Security, Social, Storage, Transaction, Visual, Wallet/Balance, Weather

## Response

Returns url, description, price, network, category, lastUpdated, quality_score (0-1), brokerable (true/false) per result — ranked by weighted relevance blended with quality score.