token-discipline-mcp

Stop your AI coding agent from burning through your usage limits.

A tiny MCP server (one file, zero dependencies) that loads a set of token-saving rules into every session of Claude Code, Claude Desktop, Cursor, or any MCP client.

What it makes your agent do

Full list: RULES.md.

Related MCP server: mcp-context-condenser

Setup (1 minute)

Needs Node 18+. Nothing to install: npx runs it straight from GitHub.

Claude Code

claude mcp add token-discipline --scope user -- npx -y github:Suhaib5333/token-discipline-mcp

Claude Desktop, Cursor, Windsurf, others

Add this to your MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, ...):

{
  "mcpServers": {
    "token-discipline": {
      "command": "npx",
      "args": ["-y", "github:Suhaib5333/token-discipline-mcp"]
    }
  }
}

Restart the client. Done ✅

How it works

The rules reach the model 3 ways, so it works whatever your client supports:

Use your own rules

Point it at any Markdown file:

claude mcp add token-discipline --scope user -e TOKEN_RULES_FILE=/path/to/my-rules.md -- npx -y github:Suhaib5333/token-discipline-mcp

(JSON config: add "env": { "TOKEN_RULES_FILE": "/path/to/my-rules.md" }.)

Or fork this repo, edit RULES.md, and swap Suhaib5333 for your username in the install command.

Run locally

git clone https://github.com/Suhaib5333/token-discipline-mcp
cd token-discipline-mcp
npm test

Contributing

Ideas for better rules are welcome. Open an issue or a PR (keep it zero-dependency and short). See CONTRIBUTING.md.

License

MIT: use it, fork it, ship it.