SmartBoy Search

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
ParameterMeaning
qThe query. Supports "exact phrase", -word, site:docs.python.org, -site:example.com, cat:docs, after:2025-01, before:2024.
nResults, 1 to 50 (default 10).
offsetSkip this many results (paging).
catComma list: docs, reference, science, health, gov, news, howto, web.
siteComma list of hosts or domains.
passagesAnswer passages per result, 0 to 5 (default 2).
charsMax characters per passage, 120 to 2000 (default 420).
textAlso return up to this many characters of each page (0 to 20000).
per_siteMax results from one host (default 2, 0 = no limit).
formatjson (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

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.