# FoundryNet Search

x402-gated **web search** gateway for AI agents. Structured results, or an AI-summarized sourced answer. No API keys, no accounts.

Part of the [FoundryNet Data Network](https://foundrynet.io?utm_source=github&utm_medium=readme&utm_campaign=foundrynet-search). Pay-per-call in USDC (x402) or bypass with an `fnet_` Forge key. Also exposed as an MCP server for Smithery/Glama/Claude.

## Tools / Endpoints

| Tool / Route | Price | Description |
|--------------|-------|-------------|
| `search` — `POST /v1/search` | $0.005 | `{query, max_results?}` → `[{title, url, snippet}]` |
| `search_enriched` — `POST /v1/search/enriched` | $0.02 | `{query}` → results **+ a Claude-generated, source-cited summary** |

Backends: **SearXNG** (JSON, if `SEARXNG_URL` configured) + **DuckDuckGo** (HTML) — free. Enrichment via Claude.

## MCP

Streamable HTTP endpoint: `https://foundrynet-search-production.up.railway.app/mcp`

```
claude mcp add --transport http foundrynet-search https://foundrynet-search-production.up.railway.app/mcp
```

Tools list without auth (discoverable). Pass an `fnet_` key as `api_key` (or `Authorization: Bearer`) to bypass payment; otherwise the tool returns an x402 `payment_required` object.

## Payment (x402)

Standard x402 v2 on Solana mainnet USDC. Discovery: `GET /x402`, `GET /.well-known/x402`, per-route `402` at `GET /x402/{route}`. Validated on [402 Index](https://402index.io).

Volume play — every agent needs web search, and $0.005/query is cheaper than most alternatives.