Developer

1.  Set your API key

# Store your key once in ~/.atc/key (read first, no restart needed):
New-Item -ItemType Directory -Force "$HOME\.atc" | Out-Null
Set-Content "$HOME\.atc\key" "atc_YOUR_KEY" -NoNewline -Encoding ascii

The ~/.atc/key file is read first and needs no restart — set it once. An ATC_API_KEY env var also works as a fallback.

2.  Download & run the hotkey

Save the script, then run it from PowerShell. Leave the window open (minimized is fine) — it listens for the hotkey in the background.

# keep this window open (minimize it)
powershell -NoProfile -ExecutionPolicy Bypass -File clean-before-send.ps1

3.  Use it

• Ctrl+Shift+K — in a GUI chat box (Claude Code / Codex desktop, web chats): type your messy prompt, press it, and the box is replaced with the cleaned version. Review, then send.
• Ctrl+Shift+J — for terminals (Codex CLI): copy your messy text, press it, then paste the cleaned text back.
• Ctrl+Shift+M — cycle mode: plain-clean → caveman → structured-clean.
• Ctrl+Shift+L — cycle the cleaner model.
• Ctrl+Shift+Q — quit.

The window shows the current mode + cleaner and reprints them on each change. ATC_MODE / ATC_MODEL just set the starting values (defaults plain-clean / gemini-2.5-flash) — change them live with Ctrl+Shift+M / L, no relaunch.

No target-model option here — a target only changes the token-count estimate shown in the playground UI; it does not affect the clean itself, and the hotkey has no display to show it against. Pick a target in the playground when you want that readout.

1.  Create an API key

Use the panel above — copy it once and keep it safe.

2.  Add the server to your client

Claude Code (CLI)

Run these commands in your terminal. The MCP connects via the claude CLI — no npm install needed.

claude mcp add token-cleaner --transport http https://aitokencleaner.com/api/mcp --header "Authorization: Bearer atc_YOUR_KEY"

claude mcp list

Cursor / other clients (mcp.json)

{
  "mcpServers": {
    "token-cleaner": {
      "url": "https://aitokencleaner.com/api/mcp",
      "headers": { "Authorization": "Bearer atc_YOUR_KEY" }
    }
  }
}

3.  Use it

Ask in chat — tell the agent to clean a prompt; it calls clean_prompt and returns the cleaned text with token stats:

Clean this with token-cleaner: "could you please write me a really nice short calm poem about the sea, nothing too long, something relaxing"

Or the slash command — /atc_clean (shown as /mcp__token-cleaner__atc_clean in Claude Code) cleans your prompt and continues with the leaner version automatically:

/atc_clean write a professional but warm email to my manager asking for Friday off for a personal appointment

Response

{
  "cleaned": "Write a short, calm poem about the sea.",
  "mode": "plain-clean",
  "model": "gemini-2.5-flash",
  "stats": {
    "original_tokens": 28,
    "cleaned_tokens": 10,
    "savings_percent": 64,
    "estimated_usd_saved": 0.0000054,
    "target_model": "gemini-2.5-flash"
  },
  "usage": { "credits_charged": 0, "cleans_today": 1, "daily_limit": 100 }
}