mcp-context-cost 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +9 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -70,11 +70,12 @@ deferral off in a settings file is not a machine running the default:
70
70
  |---|---|
71
71
  | nothing set (the default) | every definition deferred, at any size — no threshold applies |
72
72
  | `ENABLE_TOOL_SEARCH=true` | same: every definition deferred |
73
- | `ENABLE_TOOL_SEARCH=false` | deferral off — every request carries the full total |
73
+ | `ENABLE_TOOL_SEARCH=false` | deferral off — every request carries the full total. In a settings `env` block that is the **string** `"false"`; the JSON boolean `false` is the last row, not this one |
74
74
  | `ENABLE_TOOL_SEARCH=auto` / `auto:N` | deferred only once definitions reach 10% / N% of the context window |
75
75
  | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` set | tool search off — read first, because `ENABLE_TOOL_SEARCH` cannot override it |
76
76
  | `ANTHROPIC_BASE_URL` off `api.anthropic.com` | falls back to loading up front — consulted only while `ENABLE_TOOL_SEARCH` is unset |
77
77
  | anything else in `ENABLE_TOOL_SEARCH` | not a documented value, so nothing is claimed from it |
78
+ | any of the three set, in a settings `env` block, to something that is not a string — a JSON boolean, a number, `null` | it is set there and what it is set to is unknown, so no posture is claimed: the report says whether these tokens are deferred cannot be said from it |
78
79
 
79
80
  On a machine where none of them is set, the same stack reads:
80
81
 
@@ -105,11 +106,13 @@ costs **more** than loading the definitions would.
105
106
  Three things the report will not do: it will not convert between units silently (in
106
107
  threshold mode the stack is compared as a range, because the audit counts wire bytes and the
107
108
  threshold is counted in what the client sends to the API — measured at 0.20×–1.92× across 20
108
- servers); it will not pick a winner when two places on the machine set the same variable to
109
- different values, or when a settings file exists and cannot be read; and it will not pass an
110
- absence of a record off as a measurement. The first two print as unanswered questions. The
111
- third prints as an answer that names itself: for the four discovered clients with no default
112
- on record `claude-desktop`, `cursor`, `vscode`, `windsurf` the tokens are counted as
109
+ servers); it will not claim a posture the machine did not state readably, which is four
110
+ refusals and not one when two places set the same variable to different values, when a
111
+ settings file exists and cannot be read, when the place that would decide sets the variable
112
+ to something that is not a string, and when `ENABLE_TOOL_SEARCH` holds a value Claude Code
113
+ does not document; and it will not pass an absence of a record off as a measurement. The
114
+ first two print as unanswered questions. The third prints as an answer that names
115
+ itself: for the four discovered clients with no default on record — `claude-desktop`, `cursor`, `vscode`, `windsurf` — the tokens are counted as
113
116
  loaded up front, and the report says so in those words, "an absence of a record about the
114
117
  client, not a measurement of it".
115
118
  Full model, sources and dates: [METHODOLOGY §who pays the number](docs/METHODOLOGY.md#who-pays).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-context-cost",
3
- "version": "0.7.0",
3
+ "version": "0.8.0",
4
4
  "description": "Measure what your MCP servers cost in context tokens — audit your own config, or badge the server you publish",
5
5
  "type": "module",
6
6
  "license": "MIT",