Statespace

npm License Discord X

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.