statespace
Search documentation indexed from llms.txt sites — from the terminal, from your AI assistant, or over HTTP.
CLI
npx statespace search "redis connection pooling"
npx statespace search "authentication" --site upstash.com
npx statespace search "rate limiting" --limit 20
Options
| Flag | Short | Default | Description |
|---|---|---|---|
--site <site> | -s | — | Restrict to a specific site (name, domain, or URL) |
--limit <n> | -l | 10 | Max results |
--url <url> | -u | http://localhost:3000 | Backend API base URL |
MCP
Add to your MCP client config (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"statespace": {
"command": "npx",
"args": ["statespace", "mcp"]
}
}
}
For a remote backend:
{
"mcpServers": {
"statespace": {
"command": "npx",
"args": ["statespace", "mcp", "--url", "https://your-backend.example.com"]
}
}
}
To run as an SSE server instead of stdio (useful for remote or multi-client deployments):
npx statespace mcp --transport sse --port 4000
Tool: search
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | yes | — | Search query |
limit | integer | no | 10 | Max results |
site | string | no | — | Restrict to a specific site (name, domain, or URL) |
HTTP
The backend exposes a single endpoint:
GET /search?q=<query>[&limit=<n>][&site=<site>]
curl "http://localhost:3000/search?q=redis+connection+pooling"
curl "http://localhost:3000/search?q=authentication&site=upstash.com&limit=5"
Response
[
{
"url": "https://upstash.com/docs/llms.txt",
"site": "Upstash",
"title": "Upstash Docs",
"score": 0.8321
}
]
Without site, returns one result per matching site. With site, returns individual pages within that site.
Requirements
Node.js 18+
Community
- Discord: discord.gg/rRyM7zkZTf
- X: @statespace_tech
- Issues: GitHub Issues
License
This project is licensed under the terms of the MIT license.