io.github.FoundryNet/foundrynet-search
x402-gated web search gateway. Tools: search, search_enriched.
Open source Repository Open in the app JSON README (API)
About
x402-gated web search gateway. Tools: search, search_enriched.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- foundrynet
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.1
- Last push
- 2026-08-11T06:22:36Z
- Repository state
- arquivado
- Language
- JavaScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:01:55
- Updated
- 2026-08-29 03:01:55
- Origin id
io.github.FoundryNet/foundrynet-search
README
# 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.