Search Markdown and .txt pages from llms.txt sites. Available as a CLI, SDK, MCP server, and agent skill.

Installation

npm install @statespace-tech/statespace

Query syntax

Plain queries search across all sites:

mcp server setup
vector database embeddings
rate limiting middleware
oauth2 token refresh
websocket reconnection strategy

Scope a query to a specific site with site: query:

stripe: webhook verification
supabase: edge functions auth
vercel: edge middleware caching
mistral.ai: function calling               # match by domain
docs.aws.amazon.com: s3 presigned urls     # match by subdomain

Use quotes for exact phrase matching:

"context window limit"
vector database "semantic search"
stripe: "webhook signature verification"

CLI

Search documentation from the command line: npx @statespace-tech/statespace search <query> [options]

npx @statespace-tech/statespace search "mcp server setup"
npx @statespace-tech/statespace search "stripe: webhook verification" --limit 5
npx @statespace-tech/statespace search "redis connection pooling" --limit 10 --offset 3
npx @statespace-tech/statespace search "anthropic: tool function calling" --limit 5 --human

Flag	Short	Default	Max	Description
`--limit <n>`	`-l`	`10`	`50`	Max results to return
`--offset <n>`	`-o`	`0`	—	Results to skip (for pagination)
`--human`	—	—	—	Human-readable output instead of JSON

SDK

Import and call search() directly from TypeScript or JavaScript.

import { search } from '@statespace-tech/statespace';

const results = await search("mcp server setup");
const results = await search("stripe: webhook verification", { limit: 5 });
const results = await search("redis connection pooling", { limit: 10, offset: 3 });

MCP

Add to your MCP config to expose a search tool to your agents:

{
  "mcpServers": {
    "statespace": {
      "command": "npx",
      "args": ["@statespace-tech/statespace", "mcp"]
    }
  }
}

Agent skill

See SKILL.md

Requirements

Node.js 18+

Community & Contributing

Discord: Join our community server for real-time help and discussions
X: Follow us @statespace_tech for updates and news
Issues: Report bugs or request features on GitHub Issues

License

MIT

ToolFrontToolFront