v0.7.5 - the numbers are now reproducible
What's fixed
The command the README told you to run to verify our numbers never existed.
mcptoon manifest --compact --tokens was quoted in eight places as the
reproduction path. --tokens was never implemented, and unknown options were
dropped silently — so it printed a listing and no count, and looked fine.
scripts/bench_tokens.pyis now the real thing: it measures the tool lists
cached on your machine with tiktoken (cl100k_baseando200k_base) across raw
JSON,--slimand--compact. From this release's test box (4 servers, 39 tools):
raw 4,285 →--slim340 (92.1% smaller) →--compact156 (96.4% smaller).- Unknown long options now warn on stderr instead of vanishing.
- Every "reproduce it yourself" line points at the script.
mcptoon --versionworks (it used to print "Unknown command: --version").
Stale savings figures in shipped text. --slim was described as saving 93% in
the CLI help, in output.py, in the mcptoon demo hint and in the Codex
integration doc; measured it is 88.5%. --compact was described as "~20 tokens
for 96 tools"; measured it is ~2.3 tokens per tool (581 for 255).
docs/tiktoken-benchmarks.md lost a row that measured a listing truncated at 30
entries, and its older 39,964 baseline is now labelled as a separate sample against
the canonical 71,929 → 581.
README links were dead on PyPI. All 15 relative links and images resolved
against the PyPI project page (/project/mcptoon/DEVELOPERS.md/) and 404'd. They
are absolute now, with a test to keep them that way.
The English README embedded Chinese-language assets. New
assets/token-savings-en.svg and assets/demo-en.gif — the latter rendered from a
real pip install mcptoon + mcptoon demo transcript captured on a clean
virtualenv (scripts/make_demo_gif.py keeps the transcript, so only the pacing is
synthetic). assets/benchmark.svg was still charting 90,804 → 117 and is now
regenerated from assets/benchmark_tiktoken.json.
Flaky test fixed. The HTTP auth suite failed about 1 run in 5 on Windows with
Winsock 10053: the server answers 401 before reading the body, and the stack aborts
the connection while the client is still uploading. The helper now retries that
transport abort — bare, or wrapped in URLError — with a short backoff. 15
consecutive green runs of the suite verified.
694 passed, 1 skipped, 19 subtests · zero runtime dependencies · Python 3.10–3.13 on
Linux, macOS and Windows.
pip install -U mcptoon && mcptoon demo