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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
      MIT
    • A
      license
      Not graded
      quality
      B
      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.
      110 PyPI
      31
      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.
      9
      MIT
    • A
      license
      A
      quality
      B
      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.
      3
      1
      MIT