# GadgetHumans Agent API Hub

**245 MCP tools and 209 priced REST routes for AI agents.** Pay per call in USDC on Base with
[x402](https://x402.org) — no signup, no API key, free tier on every door.

Endpoint: `https://api.gadgethumans.com/mcp` (streamable HTTP)
Package: [`gadgethumans-mcp`](https://www.npmjs.com/package/gadgethumans-mcp)

## Free: cross-bazaar x402 discovery

One call searches **both live x402 bazaars plus this catalogue**, ranked by measured 30-day call volume:

```bash
curl "https://api.gadgethumans.com/discovery/search?q=whois&limit=10"
```

```json
{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"x402_search","arguments":{"q":"whois","limit":10}}}
```

Merges `facilitator.payai.network` (14,841 listings), `api.cdp.coinbase.com` (73,178 listings) and this
catalogue (209 routes), deduped by resource URL. Returns `resource`, `sources`, `price_usd`,
`calls_30d`, `payTo` and `description` per row. **$0.000**, no key, cached 900s, 120 queries/hour/IP.

Use it to compare providers and prices *before* paying any x402 endpoint.

## Connect

```bash
npx -y gadgethumans-mcp
```

```json
{ "mcpServers": { "gadgethumans": { "command": "npx", "args": ["-y", "gadgethumans-mcp"] } } }
```

## What you can call

- **Token safety** — honeypot/transfer simulation, buy and sell tax, mint and owner privileges on Base (`$0.01`)
- **Prediction markets** — live Polymarket odds, implied probability, board scans (`$0.01` / `$0.25`)
- **Web** — search and page reads to markdown
- **Network** — DNS, WHOIS, IP, geocoding
- **Markets** — crypto prices, currency conversion
- **Utilities** — hashing, UUID, timezone, VAT and IBAN validation, regex, cron parsing, distance

`tools/list` is served live from the endpoint, so new routes appear without a package update.

## Pricing

| Door | Free | Then |
|---|---|---|
| MCP (`/mcp`) | 5 calls/day per IP | `$0.002`/call, x402 |
| REST | 100 requests/day per IP | per-route price, x402 |
| `x402_search` | always free | rate limited, 120/hour/IP |

An unpaid call returns `HTTP 402` with an x402 `accepts[]` challenge (also in the `Payment-Required`
header). Settle and retry with the `X-PAYMENT` header.

## Links

- Machine-readable surface: <https://api.gadgethumans.com/llms.txt>
- OpenAPI: <https://api.gadgethumans.com/openapi.json>
- Discovery index: <https://api.gadgethumans.com/discovery>
- MCP registry: `com.gadgethumans/gadgethumans-mcp`

MIT licensed.