Skip to main content
Glama

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

Related MCP server: gnosis-mcp

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

License

This project is licensed under the terms of the MIT license.

Maintenance

ActivityInactive
ResponsivenessSyncing

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables the creation and execution of task-specific AI sub-agents defined in markdown across any MCP-compatible tool like Cursor or Claude Desktop. It integrates with execution engines such as Claude Code, Cursor CLI, and Gemini CLI to provide portable and reusable specialized agent workflows.
    1
    441
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Zero-config knowledge base for AI coding agents. Loads your markdown docs into a searchable database and exposes them as MCP tools — search, read, and manage documentation without leaving your editor. Works instantly with SQLite (no setup), upgrades to PostgreSQL + pgvector for hybrid semantic search. 6 MCP tools, 3 resources, FTS5 keyword search, 176 tests.
    29
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms Markdown documentation into an intelligent knowledge base with AI-powered search and Q\&A through an MCP server.
    11
    9
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    One config, one CLI that turns your databases (Postgres, MySQL, SQLite, MongoDB) into MCP servers for Claude, GPT, Cursor, and any MCP-compatible agent.
    1
    MIT