Spiderbrain MCP Server
by aabhisrvai.spiderbrain/spiderbrainv0.2.3
Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.
context tax
queued
security
queued
cold start
queued
freshness
Maintained49d ago
Install Spiderbrain MCP server
Install in Claude Code
claude mcp add spiderbrain -e SPIDERBRAIN_ROOT='<spiderbrain-root>' -e SPIDERBRAIN_API_KEY='<spiderbrain-api-key>' -- npx -y spiderbrain mcpInstall in Cursor
{
"mcpServers": {
"spiderbrain": {
"command": "npx",
"args": [
"-y",
"spiderbrain",
"mcp"
],
"env": {
"SPIDERBRAIN_ROOT": "<spiderbrain-root>",
"SPIDERBRAIN_API_KEY": "<spiderbrain-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"spiderbrain": {
"command": "npx",
"args": [
"-y",
"spiderbrain",
"mcp"
],
"env": {
"SPIDERBRAIN_ROOT": "<spiderbrain-root>",
"SPIDERBRAIN_API_KEY": "<spiderbrain-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"spiderbrain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"spiderbrain",
"mcp"
],
"env": {
"SPIDERBRAIN_ROOT": "<spiderbrain-root>",
"SPIDERBRAIN_API_KEY": "<spiderbrain-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"spiderbrain": {
"command": "npx",
"args": [
"-y",
"spiderbrain",
"mcp"
],
"env": {
"SPIDERBRAIN_ROOT": "<spiderbrain-root>",
"SPIDERBRAIN_API_KEY": "<spiderbrain-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| SPIDERBRAIN_ROOT | yes | — | Absolute path to the repository to serve, which must already contain a committed .spiderbrain/ folder. Set this: an MCP client's working directory is usually not your repository, and without it the server serves the working directory and reports that no understanding layer was found. Equivalent to passing --root. |
| SPIDERBRAIN_API_KEY | — | yes | Optional. Enables the cloud why-layer used by the sb_ask tool. The structural tools work offline without it. |
| SPIDERBRAIN_REGISTRY | — | — | Optional. Base URL of the public brain registry this server consults on the first tool call when the repository has no committed .spiderbrain/ folder. Defaults to https://spiderbrain.ai/registry. |
Remote endpoints
- streamable-http
https://mcp.spiderbrain.ai/mcp
Freshness
Maintained — last maintenance signal 49d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-21 · 50d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-22 · 49d ago · official registry · v0.2.3
FAQ
›How do I install the Spiderbrain MCP server in Claude Code?
Run: claude mcp add spiderbrain -e SPIDERBRAIN_ROOT='<spiderbrain-root>' -e SPIDERBRAIN_API_KEY='<spiderbrain-api-key>' -- npx -y spiderbrain mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Spiderbrain require an API key?
Yes. It expects SPIDERBRAIN_ROOT, SPIDERBRAIN_API_KEY, of which 1 is a secret.
›Can I use Spiderbrain as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Spiderbrain in the official MCP registry?
Yes, as ai.spiderbrain/spiderbrain.