{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dvuewvddcbyr","handle":"token-save-mcp","url":"https://wellknown.network/agents/token-save-mcp","links":{"self":"https://wellknown.network/agents/token-save-mcp/record.json","html":"https://wellknown.network/agents/token-save-mcp","markdown":"https://wellknown.network/agents/token-save-mcp/record.md","api":"https://wellknown.network/api/v1/agents/token-save-mcp","status":"https://wellknown.network/api/v1/agents/token-save-mcp/status","claim":"https://wellknown.network/agents/token-save-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/token-save-mcp/claim.json","badge":"https://wellknown.network/agents/token-save-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/token-save-mcp/history","tools":"https://wellknown.network/api/v1/agents/token-save-mcp/tools"},"ard":{"identifier":"urn:air::server:token-save-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"token-save-mcp","summary":"MCP server that keeps large files out of your coding agent's context by delegating reads to a cheap worker model. Enforced by a hook, measured per call.","description":"# token-save-mcp\n\n**Your coding agent burns its context reading files. This stops it — and shows you the receipt.**\n\n[![CI](https://github.com/Habartru/token_save_mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Habartru/token_save_mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/token-save-mcp.svg)](https://pypi.org/project/token-save-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Habartru/token_save_mcp/blob/main/LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\nRead one 4,000-line file and ~35,000 tokens sit in your agent's context for the\nrest of the session. Read a few more and it compacts, forgets your\ninstructions, and every later turn costs more — because each one pays for the\nwhole accumulated context again.\n\nThis MCP server sends those files to a cheap worker model instead and returns\nonly the answer. The bytes are paid for once, in the worker's context, not\npermanently in yours.\n\n![token-save-mcp in action](https://raw.githubusercontent.com/Habartru/token_save_mcp/main/docs/demo.gif)\n\nThe hook **blocks** the expensive read and redirects it. The answer comes back\nwith the worker's **real token usage from the API response** — not an estimate,\na receipt:\n\n```\n─────────────────────────────────────────────────────────────\ntoken-save: 1 file, 606 lines | direct read ≈7,042 tok →\ninto context ≈234 tok (saved 6,808 · 97%)\nworker: glm-5.3-flash | 6,155 in / 278 out | 4.0s\n```\n\n*(`glm-5.3-flash` is just the worker configured in that run — you pick your own.)*\n\n---\n\n## Install\n\nTwo commands, plus an API key of your own.\n\n```bash\npip install token-save-mcp\ntoken-save-mcp init --hook\n```\n\n`init` finds a provider key you already have, registers the MCP server with\nyour agent, and installs the hook. If you have no key yet it prints the\noptions and where to get one.\n\nOne package, one command. There is no second MCP server to ad…","publisher":null,"homepage":"https://github.com/Habartru/token_save_mcp","repository":"https://github.com/Habartru/token_save_mcp","version":"0.4.1","license":"MIT License\n        \n        Copyright (c) 2026 Habartru\n      …","protocols":["mcp"],"tags":["ai-coding","claude","claude-code","context-window","cursor","developer-tools","llm","mcp","model-context-protocol","ollama","openrouter","token-optimization"],"pricing":null,"endpoints":[{"url":"pypi:token-save-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"ai.model-access","name":"Model Access","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["ai","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"token-save-mcp","registry":"pypi","observedAt":"2026-10-22T22:24:39.226Z","publishedAt":"2026-09-19T08:51:55.422072Z","latestVersion":"0.4.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"token-save-mcp","url":"https://pypi.org/project/token-save-mcp/","firstSeenAt":"2026-09-22T17:25:29.642Z","fetchedAt":"2026-10-22T22:22:56.464Z","normalizedAt":"2026-10-22T22:22:56.464Z"}]},"firstSeenAt":"2026-09-22T17:25:29.642Z","updatedAt":"2026-10-22T22:24:39.226Z"}