state-trace MCP Server

by razrooio.github.razroo/state-tracev0.3.1

Bounded working memory for coding agents — typed nodes, current-vs-stale state, MCP-mountable.

Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing6mo ago

Install state-trace MCP server

claude mcp add state-trace -- uvx state-trace

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "state-trace": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "state-trace"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "state-trace": {
      "command": "uvx",
      "args": [
        "state-trace"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
STATE_TRACE_STORAGE_PATH	—	—	Path to the SQLite or JSON file backing the working-memory graph. .db/.sqlite/.sqlite3 = SQLite (recommended); other = JSON. Defaults to ~/.state-trace/memory.db.
STATE_TRACE_NAMESPACE	—	—	Namespace to scope reads and writes (e.g. the repo slug). Nodes without a namespace remain visible to all namespaces.
STATE_TRACE_CAPACITY_LIMIT	—	—	Working-memory budget in capacity units. Default 256.