English Français العربية

state-trace

Official registry Developer tools

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

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package state-trace
Claude Code 
claude mcp add state-trace -e 'STATE_TRACE_STORAGE_PATH=<STATE_TRACE_STORAGE_PATH>' -e 'STATE_TRACE_NAMESPACE=<STATE_TRACE_NAMESPACE>' -e 'STATE_TRACE_CAPACITY_LIMIT=<STATE_TRACE_CAPACITY_LIMIT>' -- uvx state-trace==0.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "state-trace": {
            "command": "uvx",
            "args": [
                "state-trace==0.3.1"
            ],
            "env": {
                "STATE_TRACE_STORAGE_PATH": "<STATE_TRACE_STORAGE_PATH>",
                "STATE_TRACE_NAMESPACE": "<STATE_TRACE_NAMESPACE>",
                "STATE_TRACE_CAPACITY_LIMIT": "<STATE_TRACE_CAPACITY_LIMIT>"
            }
        }
    }
}

Environment variables

  • 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.

Frequently asked questions

What is state-trace?

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

How do I install state-trace?

It runs on your machine. In Claude Code: claude mcp add state-trace -e 'STATE_TRACE_STORAGE_PATH=<STATE_TRACE_STORAGE_PATH>' -e 'STATE_TRACE_NAMESPACE=<STATE_TRACE_NAMESPACE>' -e 'STATE_TRACE_CAPACITY_LIMIT=<STATE_TRACE_CAPACITY_LIMIT>' -- uvx state-trace==0.3.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does state-trace need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is state-trace open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains state-trace?

It is published by razroo. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.