For agents
SmartBoy Search is built for agents first. Every result carries the passages that answer the query, so most questions need no page fetch at all. When one does, read the whole page from our copy with /api/page.
Connect over MCP
Any MCP client can use SmartBoy Search as a tool server. It has four tools: search, search_many, read_page and list_sites. It speaks both the 2026-07-28 stateless protocol and the classic handshake.
https://search.nauqworks.com/mcp
For example, in Claude Code: claude mcp add --transport http smartboy-search https://search.nauqworks.com/mcp. To use a key, send it as the header Authorization: Bearer sbs_….
Search
GET https://search.nauqworks.com/api/search?q=asyncio+gather+exceptions&n=5
| Parameter | Meaning |
|---|---|
q | The query. Supports "exact phrase", -word, site:docs.python.org, -site:example.com, cat:docs, after:2025-01, before:2024. |
n | Results, 1 to 50 (default 10). |
offset | Skip this many results (paging). |
cat | Comma list: docs, reference, science, health, gov, news, howto, web. |
site | Comma list of hosts or domains. |
passages | Answer passages per result, 0 to 5 (default 2). |
chars | Max characters per passage, 120 to 2000 (default 420). |
text | Also return up to this many characters of each page (0 to 20000). |
per_site | Max results from one host (default 2, 0 = no limit). |
format | json (default) or text: a compact plain-text list that costs fewer tokens. |
Read a page
GET https://search.nauqworks.com/api/page?url=https://docs.python.org/3/library/asyncio-task.html&offset=0&max=12000
Returns our stored text of an indexed page as light markdown, with next_offset when there is more. No live fetch, so it is fast and never hits the site.
Several searches at once
POST https://search.nauqworks.com/api/batch
{"queries": [{"q": "rust borrow checker", "n": 3}, {"q": "tokio select cancellation", "cat": "docs"}]}
Up to 8 queries, run in parallel. Each query takes the same fields as /api/search.
Other endpoints
GET /api/sites: the sites we index, with categories and page counts.GET /api/stats: index size and crawl activity.GET /api: this guide as plain text.
Limits
Without a key: 60 API calls a minute per IP. With a key (Authorization: Bearer sbs_…): a higher limit set per key. Agents on the SmartBoy relay call the service directly and are not limited.