# Search402 — full documentation for language models --- > Pay-per-call web search and page extraction for AI agents. x402, USDC on Base. Index: 27097 pages, 2333 domains. --- # Quickstart: web search for AI agents in 3 steps Search402 is a pay-per-call web search and page-extraction API for AI agents. No sign-up and no API key: each call is paid with the x402 protocol in USDC on Base. ## 1. Try it free ```bash curl "https://search.missioncoregroup.com/v1/preview?q=postgres+full+text+search" ``` Returns the top 3 titles and URLs as Markdown (20 free calls a day per IP). ## 2. Give your agent a wallet Any Base wallet holding a little USDC (a few dollars covers ~1,000 searches at $0.005). Use a dedicated wallet. ## 3. Call the paid endpoint with an x402 client ```js import { wrapFetchWithPaymentFromConfig } from "@x402/fetch"; import { ExactEvmScheme } from "@x402/evm"; import { privateKeyToAccount } from "viem/accounts"; const pay = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(process.env.KEY)) }] }); const res = await pay("https://search.missioncoregroup.com/v1/search?q=postgres+gin+index&format=json"); console.log(await res.json()); ``` ```python from eth_account import Account from x402 import x402Client from x402.http.clients import x402HttpxClient from x402.mechanisms.evm.exact import ExactEvmClientScheme client = x402Client().register("eip155:8453", ExactEvmClientScheme(Account.from_key(KEY))) async with x402HttpxClient(client) as http: r = await http.get("https://search.missioncoregroup.com/v1/search?q=python+asyncio&format=json") ``` Next: [API reference](https://search.missioncoregroup.com/docs/api.md) · [MCP setup](https://search.missioncoregroup.com/docs/mcp.md) · [Pricing](https://search.missioncoregroup.com/docs/pricing.md) --- # Search402 API reference Base URL: `https://search.missioncoregroup.com` · OpenAPI 3.1: `https://search.missioncoregroup.com/schema.json` · x402 manifest: `https://search.missioncoregroup.com/.well-known/x402.json` | Method | Path | Price | Description | |---|---|---|---| | GET | /v1/search | $0.005 | Ranked web results with snippets. Params: `q` (required), `limit` 1-25, `site`, `format` | | GET | /v1/extract | $0.002 | Main content of one public URL as Markdown, plus its JSON-LD. Params: `url`, `format` | | GET | /v1/preview | free | Top 3 titles + URLs, 20/day per IP. Param: `q` | | GET | /v1/status | free | Index size, freshness, prices, payment status | | POST | /mcp | free tools | MCP Streamable HTTP server | ## Formats `format=md` (default, GitHub-flavoured Markdown), `format=json`, `format=jsonld` (schema.org SearchResultsPage / WebPage). The `Accept` header works too. ## Response headers | Header | Meaning | |---|---| | X-Agent-RateLimit-Remaining | calls left in the current 60 s window | | X-Data-Freshness-Timestamp | ISO time of the oldest data in the body | | X-Token-Cost | estimated LLM tokens in the body | | X-Price-USDC | price of this call | | X-Cache | HIT or MISS | | PAYMENT-RESPONSE | x402 settlement receipt (base64 JSON with the Base transaction hash) | ## Errors 400 bad input · 402 payment required · 429 rate limited (Retry-After) · 451 blocked by the site's robots.txt · 502 site unreachable. --- # Use Search402 from Claude, Cursor or any MCP client Remote MCP server (Streamable HTTP): `https://search.missioncoregroup.com/mcp` Tools: `search_preview` (free top-3 results), `index_status`, `how_to_pay` (exact paid URLs and x402 steps). ## Claude Code ```bash claude mcp add --transport http search402 https://search.missioncoregroup.com/mcp ``` ## Cursor / VS Code / other clients (mcp.json) ```json { "mcpServers": { "search402": { "type": "http", "url": "https://search.missioncoregroup.com/mcp" } } } ``` Server card: `https://search.missioncoregroup.com/.well-known/mcp.json` --- # Search402 pricing | Call | Price (USDC on Base) | |---|---| | Search | $0.005 | | Extract one page | $0.002 | | Preview (top 3) | free, 20/day per IP | | MCP tools | free | No subscription, no minimum, no account. Each call settles on Base through x402; the receipt is in the `PAYMENT-RESPONSE` header. A few dollars of USDC covers about a thousand searches. --- # What is x402 search? **x402** is an open payment protocol built on the HTTP 402 "Payment Required" status code. A server answers an unpaid request with 402 and machine-readable terms (price, asset, network, recipient). The client signs a stablecoin payment authorisation and retries the same request with a `PAYMENT-SIGNATURE` header. A facilitator verifies and settles the payment on-chain, and the server returns the data. **x402 search** means a search API sold this way: AI agents pay per query instead of managing API keys, accounts and monthly plans. Search402 is one such API: $0.005 per search and $0.002 per page extraction, in USDC on Base (CAIP-2 `eip155:8453`). Why agents prefer it: - no sign-up flow an autonomous agent cannot complete; - cost known before each call, with the token cost of the answer in `X-Token-Cost`; - spend capped by the wallet balance. --- # Search402 FAQ **Do I need an API key?** No. Payment per call with x402 replaces keys. **Which network and token?** USDC on Base mainnet (`eip155:8453`, contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). **Does the payer need ETH for gas?** No. The payer signs an EIP-3009 authorisation; the facilitator submits it. **Where do results come from?** Our own index, crawled by Search402Bot (robots.txt respected), plus pages agents extract. **Is there a free tier?** `/v1/preview` (top 3 results, 20/day) and the MCP tools. **How fresh is the data?** Each response states it in `X-Data-Freshness-Timestamp`; pages are re-crawled about every 14 days. **Who runs it?** MissionCore Group (hello@missioncoregroup.com).