mcp-baggage 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mtalhasahin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# Baggage
+
+**What each MCP server carries into your context window, and how much of it you actually use.**
+
+Installing an MCP server is free. Keeping one is not. Every tool a server declares is sent to the
+model on every single request — its name, its description and its whole JSON schema — whether or not
+anything ever calls it. Ten servers is a few thousand tokens off the top of every turn, in every
+session, forever. Nobody shows you that number.
+
+```
+npx mcp-baggage
+```
+
+```
+  server               tools   tokens  of ctx    used
+
+  playwright              24     8.9k    4.5%    0/24  never called
+  github                  35     6.1k    3.1%    3/35
+  filesystem              14     2.4k    1.2%    9/14
+  sentry                  12     1.4k    0.7%    1/12
+  postgres                 6      702    0.4%     4/6
+  broken                   —        —       —       —  server exited (1): MCP_TOKEN is not set
+
+  total                   91    19.5k    9.8%
+
+every request carries 19.5k tokens of tool definitions — 9.8% of a 200k window,
+before a line of your own code is read. (estimated — --exact counts)
+
+12.7k of it — 65% — has not been called in 30 days.
+
+nothing at all has been called from:
+
+  playwright               8.9k  ~/.cursor/mcp.json
+
+and these tools, in servers you do use:
+
+  mcp__github__create_or_update_file               287
+  mcp__github__list_workflow_runs                  241
+  mcp__github__update_pull_request_branch          224
+  … and 29 more
+```
+
+The two halves of that table are the whole idea. The left is what you pay on every request. The
+right is what you got for it. Nobody sets out to spend a tenth of their context on a browser
+automation server they last used in March — it is just that the cost is invisible and the decision
+was never put in front of them.
+
+---
+
+## What it does
+
+- Finds every MCP config on the machine — Claude Code, Cursor, Codex, VS Code, Windsurf — and reads
+  whichever exist.
+- Starts each server, asks it what it carries, and closes the connection. **No tool is ever called.**
+- Weighs each tool as the model will be shown it: `mcp__server__tool`, the description and the input
+  schema, serialized the way the request serializes it.
+- Reads your Claude Code transcripts for `tool_use` blocks, so every tool gets a count of the times
+  it was actually reached for.
+- Folds duplicates: the same server in three configs is weighed once and the report names all three.
+
+## What it does not do
+
+It does not call tools, write files, change any config, or send your schemas anywhere — except under
+`--exact`, which posts the tool definitions to Anthropic's token-counting endpoint and nothing else.
+It has no dependencies. It spawns the servers your own config already tells your editor to spawn,
+and you can see exactly which ones first:
+
+```bash
+npx mcp-baggage --list
+```
+
+---
+
+## The number
+
+There is no public tokenizer for Claude, so the default figure is an estimate. It is not
+`length / 4`: tool definitions are JSON, and JSON is mostly punctuation, indentation and short
+identifiers, which that ratio gets wrong in both directions at once. Instead the text is cut into
+runs — letters, digits, whitespace, punctuation — and each is priced the way a byte-pair tokenizer
+is known to treat it.
+
+It is a model of a tokenizer, not the tokenizer, and it is good enough for the question it is for:
+*which of these is the big one*. When the number itself has to be right:
+
+```bash
+ANTHROPIC_API_KEY=... npx mcp-baggage --exact
+```
+
+That sends each server's tool definitions to `/v1/messages/count_tokens`, which returns what the
+model would actually be charged — framing, separators and all — and subtracts a baseline call with
+no tools. It runs no inference and bills nothing.
+
+## Usage
+
+```
+mcp-baggage [options]
+
+  --tools            list every tool with its own weight
+  --list             show the servers found, without starting any of them
+  --json             machine-readable output
+  --exact            count with the Anthropic API instead of estimating
+
+  --days <n>         days of transcripts to read for usage (default 30)
+  --no-usage         skip transcripts entirely
+  --window <n>       context window to measure the share against (default 200000)
+  --client <name>    only servers from one client
+  --all              include servers the config has switched off
+  --timeout <ms>     how long a server gets to answer (default 20000)
+  --cwd <path>       treat another directory as the project
+```
+
+Progress goes to stderr and the report to stdout, so `mcp-baggage --json > baggage.json` gives you
+the figures and still shows you what is happening while a dozen servers start up.
+
+## Where it looks
+
+| Client | User | Project |
+| --- | --- | --- |
+| Claude Code | `~/.claude.json` | `.mcp.json` |
+| Cursor | `~/.cursor/mcp.json` | `.cursor/mcp.json` |
+| VS Code | — | `.vscode/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` | — |
+| Codex | `~/.codex/config.toml` | — |
+
+Both transports are spoken: stdio, where the server is a process to spawn, and streamable HTTP,
+where it is a URL. A server that cannot be reached is a row in the table with its own error, not a
+failed run — and it is left out of the total rather than quietly counted as zero.
+
+Usage counts come from Claude Code's transcripts, because it is the only client that keeps them in a
+documented place. With no transcripts, the `used` column reads `—`. **Unknown is never printed as
+zero**, and a tool that was never measured is never called waste.
+
+## In a script
+
+The same figures, without the table:
+
+```js
+import { scan } from 'mcp-baggage';
+
+const { tokens, servers } = await scan();
+if (tokens > 15_000) {
+  console.error(`MCP tool definitions are ${tokens} tokens; budget is 15000`);
+  process.exit(1);
+}
+```
+
+## Install
+
+```bash
+npx mcp-baggage          # no install
+npm i -g mcp-baggage     # or keep it around
+```
+
+Node 20.10 or newer. No dependencies.
+
+---
+
+MIT © [mtalhasahin](https://github.com/mtalhasahin)

package/dist/bin.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * The entry point, and nothing else.
+ *
+ * `cli.ts` holds the argument parsing and the run so that both can be tested
+ * without a process; this file is the part that cannot be — it takes the exit
+ * code and ends.
+ */
+export {};

package/dist/bin.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * The entry point, and nothing else.
+ *
+ * `cli.ts` holds the argument parsing and the run so that both can be tested
+ * without a process; this file is the part that cannot be — it takes the exit
+ * code and ends.
+ */
+import { main } from "./cli.js";
+main(process.argv.slice(2)).then((code) => process.exit(code), (e) => {
+    process.stderr.write(`${e instanceof Error ? (e.stack ?? e.message) : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,CAAU,EAAE,EAAE;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The command.
+ *
+ * Runs with no arguments and no configuration: find the configs, ask every
+ * server what it carries, read the transcripts for what was used, print one
+ * table. Everything else is a flag for a narrower question.
+ *
+ * Progress goes to stderr and the report to stdout, so `mcp-baggage > out.txt`
+ * keeps the report and still shows the person what is happening while a dozen
+ * servers start up.
+ */
+type Options = {
+    tools: boolean;
+    list: boolean;
+    json: boolean;
+    exact: boolean;
+    usage: boolean;
+    all: boolean;
+    days: number;
+    window: number;
+    timeout: number;
+    client?: string;
+    cwd: string;
+};
+/** Flags, with the errors a person can act on rather than a stack trace. */
+export declare function parseArgs(argv: readonly string[]): Options | {
+    help: true;
+} | {
+    version: true;
+} | {
+    error: string;
+};
+export declare function main(argv: readonly string[]): Promise<number>;
+export {};

package/dist/cli.js

@@ -0,0 +1,215 @@
+/**
+ * The command.
+ *
+ * Runs with no arguments and no configuration: find the configs, ask every
+ * server what it carries, read the transcripts for what was used, print one
+ * table. Everything else is a flag for a narrower question.
+ *
+ * Progress goes to stderr and the report to stdout, so `mcp-baggage > out.txt`
+ * keeps the report and still shows the person what is happening while a dozen
+ * servers start up.
+ */
+import { homedir } from 'node:os';
+import { discover } from "./config.js";
+import { exactly } from "./exact.js";
+import { DEFAULT_TIMEOUT, inspectAll } from "./mcp.js";
+import { asJson, breakdown, DEFAULT_WINDOW, report } from "./report.js";
+import { DEFAULT_DAYS, lookup, readUsage } from "./usage.js";
+import { heaviestFirst, weigh } from "./weigh.js";
+const VERSION = '0.1.0';
+const HELP = `mcp-baggage ${VERSION}
+
+  What each MCP server carries into your context window, and how much of it
+  you actually use.
+
+  mcp-baggage [options]
+
+  --tools            list every tool with its own weight
+  --list             show the servers found, without starting any of them
+  --json             machine-readable output
+  --exact            count with the Anthropic API instead of estimating
+                     (needs ANTHROPIC_API_KEY; bills nothing)
+
+  --days <n>         days of transcripts to read for usage (default ${DEFAULT_DAYS})
+  --no-usage         skip transcripts entirely
+  --window <n>       context window to measure the share against (default ${DEFAULT_WINDOW})
+  --client <name>    only servers from one client: claude-code, cursor, codex, vscode, windsurf
+  --all              include servers the config has switched off
+  --timeout <ms>     how long a server gets to answer (default ${DEFAULT_TIMEOUT})
+  --cwd <path>       treat another directory as the project
+  --version, --help
+`;
+/** Flags, with the errors a person can act on rather than a stack trace. */
+export function parseArgs(argv) {
+    const options = {
+        tools: false,
+        list: false,
+        json: false,
+        exact: false,
+        usage: true,
+        all: false,
+        days: DEFAULT_DAYS,
+        window: DEFAULT_WINDOW,
+        timeout: DEFAULT_TIMEOUT,
+        cwd: process.cwd(),
+    };
+    const number = (raw, flag) => {
+        const n = Number(raw);
+        return raw !== undefined && Number.isFinite(n) && n > 0 ? n : `${flag} needs a positive number`;
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                return { help: true };
+            case '--version':
+            case '-v':
+                return { version: true };
+            case '--tools':
+                options.tools = true;
+                break;
+            case '--list':
+                options.list = true;
+                break;
+            case '--json':
+                options.json = true;
+                break;
+            case '--exact':
+                options.exact = true;
+                break;
+            case '--no-usage':
+                options.usage = false;
+                break;
+            case '--all':
+                options.all = true;
+                break;
+            case '--days':
+            case '--window':
+            case '--timeout': {
+                const value = number(next, arg);
+                if (typeof value === 'string')
+                    return { error: value };
+                if (arg === '--days')
+                    options.days = value;
+                if (arg === '--window')
+                    options.window = value;
+                if (arg === '--timeout')
+                    options.timeout = value;
+                i++;
+                break;
+            }
+            case '--client':
+                if (!next)
+                    return { error: '--client needs a name' };
+                options.client = next;
+                i++;
+                break;
+            case '--cwd':
+                if (!next)
+                    return { error: '--cwd needs a path' };
+                options.cwd = next;
+                i++;
+                break;
+            default:
+                return { error: `unknown option: ${arg}` };
+        }
+    }
+    return options;
+}
+const out = (lines) => {
+    process.stdout.write(`${lines.join('\n')}\n`);
+};
+const note = (text) => {
+    if (process.stderr.isTTY)
+        process.stderr.write(`${text}\n`);
+};
+export async function main(argv) {
+    const parsed = parseArgs(argv);
+    if ('help' in parsed) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if ('version' in parsed) {
+        process.stdout.write(`${VERSION}\n`);
+        return 0;
+    }
+    if ('error' in parsed) {
+        process.stderr.write(`${parsed.error}\n\nmcp-baggage --help\n`);
+        return 2;
+    }
+    const options = parsed;
+    const { specs, files } = await discover(options.cwd);
+    const wanted = specs
+        .filter((s) => options.all || s.enabled)
+        .filter((s) => !options.client || s.carriedBy.includes(options.client));
+    if (wanted.length === 0) {
+        out([
+            specs.length === 0
+                ? 'no MCP servers found in any config on this machine'
+                : `no servers match — ${specs.length} found, all filtered out`,
+            '',
+            files.length ? `looked in:\n${files.map((f) => `  ${f}`).join('\n')}` : 'looked in the usual places and found no config',
+        ]);
+        return 0;
+    }
+    if (options.list) {
+        out([
+            `${wanted.length} server${wanted.length === 1 ? '' : 's'} in ${files.length} config${files.length === 1 ? '' : 's'}`,
+            '',
+            ...wanted.map((s) => `  ${s.name.padEnd(20).slice(0, 20)} ${s.transport.padEnd(6)} ${s.carriedBy.join(', ').padEnd(24)} ${s.enabled ? '' : '(switched off) '}${s.source}`),
+        ]);
+        return 0;
+    }
+    note(`asking ${wanted.length} server${wanted.length === 1 ? '' : 's'} what they carry…`);
+    let done = 0;
+    const inventories = await inspectAll(wanted, {
+        timeout: options.timeout,
+        onDone: (inv) => {
+            done++;
+            const what = inv.error ? `failed: ${inv.error}` : `${inv.tools.length} tools`;
+            note(`  [${done}/${wanted.length}] ${inv.server.name} — ${what}`);
+        },
+    });
+    const usage = options.usage ? await readUsage(options.days) : null;
+    if (options.usage && !usage)
+        note('no Claude Code transcripts found — usage is left unknown');
+    let exactTokens = null;
+    if (options.exact) {
+        const apiKey = process.env['ANTHROPIC_API_KEY'];
+        if (!apiKey) {
+            process.stderr.write('--exact needs ANTHROPIC_API_KEY in the environment\n');
+            return 2;
+        }
+        note('counting with the API…');
+        try {
+            exactTokens = await exactly(inventories, apiKey);
+        }
+        catch (e) {
+            process.stderr.write(`exact count failed, falling back to the estimate: ${e instanceof Error ? e.message : e}\n`);
+        }
+    }
+    const callsOf = lookup(usage);
+    const weighed = heaviestFirst(inventories.map((inv) => {
+        const server = weigh(inv, callsOf);
+        const exact = exactTokens?.get(inv.server.name);
+        return exact === undefined ? server : { ...server, tokens: exact };
+    }));
+    if (options.json) {
+        out([JSON.stringify(asJson(weighed, options.window, exactTokens !== null), null, 2)]);
+        return 0;
+    }
+    note('');
+    out([
+        ...report(weighed, {
+            window: options.window,
+            days: usage ? usage.days : null,
+            home: homedir(),
+            exact: exactTokens !== null,
+        }),
+        ...(options.tools ? breakdown(weighed) : []),
+    ]);
+    return weighed.every((s) => s.error) ? 1 : 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG,eAAe,OAAO;;;;;;;;;;;;;sEAamC,YAAY;;4EAEN,cAAc;;;iEAGzB,eAAe;;;CAG/E,CAAC;AAgBF,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC/C,MAAM,OAAO,GAAY;QACvB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,eAAe;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAuB,EAAE,IAAY,EAAmB,EAAE;QACxE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,0BAA0B,CAAC;IAClG,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxB,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;gBACtB,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,UAAU,CAAC;YAChB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBACvD,IAAI,GAAG,KAAK,QAAQ;oBAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;gBAC3C,IAAI,GAAG,KAAK,UAAU;oBAAE,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;gBAC/C,IAAI,GAAG,KAAK,WAAW;oBAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;gBACjD,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,CAAC;YACD,KAAK,UAAU;gBACb,IAAI,CAAC,IAAI;oBAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;gBACrD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;gBACtB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,CAAC,IAAI;oBAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;gBAClD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;gBACnB,CAAC,EAAE,CAAC;gBACJ,MAAM;YACR;gBACE,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,EAAE,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,KAAwB,EAAQ,EAAE;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC,CAAC;AACF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;IAClC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AAC9D,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,0BAA0B,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC;IAEvB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC;SACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC;YACF,KAAK,CAAC,MAAM,KAAK,CAAC;gBAChB,CAAC,CAAC,oDAAoD;gBACtD,CAAC,CAAC,sBAAsB,KAAK,CAAC,MAAM,0BAA0B;YAChE,EAAE;YACF,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,gDAAgD;SACzH,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,GAAG,CAAC;YACF,GAAG,MAAM,CAAC,MAAM,UAAU,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YACpH,EAAE;YACF,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CACvJ;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,UAAU,MAAM,CAAC,MAAM,UAAU,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAEzF,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,WAAW,GAAgB,MAAM,UAAU,CAAC,MAAM,EAAE;QACxD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACd,IAAI,EAAE,CAAC;YACP,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC;YAC9E,IAAI,CAAC,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,IAAI,CAAC,0DAA0D,CAAC,CAAC;IAE9F,IAAI,WAAW,GAA+B,IAAI,CAAC;IACnD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC7E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,aAAa,CAC3B,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACrE,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,GAAG,CAAC;QACF,GAAG,MAAM,CAAC,OAAO,EAAE;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YAC/B,IAAI,EAAE,OAAO,EAAE;YACf,KAAK,EAAE,WAAW,KAAK,IAAI;SAC5B,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Where the servers are declared, and what they are.
+ *
+ * Every client keeps its own file in its own shape, and most people have the
+ * same handful of servers in two or three of them. This finds the files, reads
+ * whichever exist, and folds identical servers together — a server is the same
+ * server when it is the same command or the same URL, whatever each config
+ * chose to call it.
+ */
+import type { ServerSpec } from './types.ts';
+/** One config file that might exist. */
+export type Candidate = {
+    client: string;
+    scope: 'user' | 'project';
+    path: string;
+    format: 'json' | 'toml';
+};
+/**
+ * The files worth looking at, in the order a report should mention them.
+ *
+ * Project files come after the user ones for each client so that a project
+ * entry overrides the machine-wide one of the same name, which is how every
+ * client resolves it.
+ */
+export declare function candidates(cwd: string, home?: string): Candidate[];
+/**
+ * The servers one file declares.
+ *
+ * Exported and taking text rather than a path so that it can be tested against
+ * every client's shape without a filesystem: `mcpServers` for Claude Code,
+ * Cursor and Windsurf, `servers` for VS Code, `mcp_servers` for Codex.
+ */
+export declare function parseConfig(text: string, at: Candidate, cwd?: string): ServerSpec[];
+/** What makes two entries the same server: the thing that gets run, not the name. */
+export declare function identity(spec: ServerSpec): string;
+/**
+ * Folds duplicates together.
+ *
+ * The first sighting wins the name and the file shown, later ones only add
+ * their client to `carriedBy` — except that a project-scoped entry replaces a
+ * user-scoped one, which is the override every client applies.
+ */
+export declare function merge(specs: readonly ServerSpec[]): ServerSpec[];
+/** Every server declared on this machine, for this directory. */
+export declare function discover(cwd: string, home?: string): Promise<{
+    specs: ServerSpec[];
+    files: string[];
+}>;