https://github.com/statespace-tech/statespace-mcp
MCP server to connect to Statespace apps.
https://github.com/statespace-tech/statespace-mcp
api mcp model-context-protocol
Last synced: 20 days ago
JSON representation
MCP server to connect to Statespace apps.
- Host: GitHub
- URL: https://github.com/statespace-tech/statespace-mcp
- Owner: statespace-tech
- License: mit
- Created: 2026-03-27T08:15:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T04:00:02.000Z (about 2 months ago)
- Last Synced: 2026-04-22T05:44:01.877Z (about 2 months ago)
- Topics: api, mcp, model-context-protocol
- Language: TypeScript
- Homepage: https://statespace.com/
- Size: 8.39 MB
- Stars: 5
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# statespace
[](https://www.npmjs.com/package/statespace)
[](https://github.com/statespace-tech/statespace-mcp-server/blob/main/LICENSE)
[](https://discord.gg/rRyM7zkZTf)
[](https://x.com/statespace_tech)
Search documentation indexed from [llms.txt](https://llmstxt.org/) sites — from the terminal, from your AI assistant, or over HTTP.
## CLI
```bash
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 ` | `-s` | — | Restrict to a specific site (name, domain, or URL) |
| `--limit ` | `-l` | 10 | Max results |
| `--url ` | `-u` | `http://localhost:3000` | Backend API base URL |
## MCP
Add to your MCP client config (Claude Desktop, Cursor, etc.):
```json
{
"mcpServers": {
"statespace": {
"command": "npx",
"args": ["statespace", "mcp"]
}
}
}
```
For a remote backend:
```json
{
"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):
```bash
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=[&limit=][&site=]
```
```bash
curl "http://localhost:3000/search?q=redis+connection+pooling"
curl "http://localhost:3000/search?q=authentication&site=upstash.com&limit=5"
```
**Response**
```json
[
{
"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](https://discord.gg/rRyM7zkZTf)
- **X**: [@statespace_tech](https://x.com/statespace_tech)
- **Issues**: [GitHub Issues](https://github.com/statespace-tech/statespace-mcp-server/issues)
## License
This project is licensed under the terms of the MIT license.