Skip to content
MCP server

Token Savior

Structural codebase MCP server with persistent memory: navigate by symbol, recall across…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
4.13.0
Listing updated
6 days ago

About Token Savior

Token Savior is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Structural codebase MCP server with persistent memory: navigate by symbol, recall across sessions.

Install

Run in a terminal

claude mcp add token-savior --env WORKSPACE_ROOTS='<WORKSPACE_ROOTS>' -- uvx token-savior-recall

Add to claude_desktop_config.json

{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<WORKSPACE_ROOTS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<WORKSPACE_ROOTS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "token-savior": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<WORKSPACE_ROOTS>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<WORKSPACE_ROOTS>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": [
        "token-savior-recall"
      ],
      "env": {
        "WORKSPACE_ROOTS": "<WORKSPACE_ROOTS>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WORKSPACE_ROOTSComma-separated list of absolute paths to project roots to index.Required
  • TOKEN_SAVIOR_CLIENTOptional client identifier (e.g. 'claude-code', 'cursor', 'hermes') for usage attribution.
  • TOKEN_SAVIOR_PROFILEManifest size. 'optimized' (recommended) advertises the Pareto-optimal 15-tool set; 'auto' sizes it from your own usage; 'full' advertises every tool; 'compact-only' if you already run symbol navigation elsewhere.

Pricing

Open source

Token Savior FAQ

Is Token Savior free?

Yes. Token Savior is open source, so you can use and self-host it for free.

How do I add Token Savior to Claude Code?

Run this command in your terminal: claude mcp add token-savior --env WORKSPACE_ROOTS='<WORKSPACE_ROOTS>' -- uvx token-savior-recall

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers