mcp-baggage 0.1.0

package/dist/toml.js

@@ -0,0 +1,145 @@
+/**
+ * Just enough TOML to read Codex's config.  [PURE]
+ *
+ * Codex keeps its servers in `~/.codex/config.toml`, and a dependency would be
+ * a poor trade for the handful of shapes that file actually uses: table
+ * headers, strings, integers, booleans, string arrays and inline tables. What
+ * this cannot parse it skips rather than guesses at, and an unreadable file
+ * costs one client, not the run.
+ */
+function parseValue(raw) {
+    const text = raw.trim();
+    if (!text)
+        return undefined;
+    if (text.startsWith('"'))
+        return unquote(text, '"');
+    if (text.startsWith("'"))
+        return unquote(text, "'");
+    if (text === 'true')
+        return true;
+    if (text === 'false')
+        return false;
+    if (text.startsWith('[')) {
+        const inner = text.slice(1, text.endsWith(']') ? -1 : undefined);
+        return splitTop(inner).map(parseValue).filter((v) => v !== undefined);
+    }
+    if (text.startsWith('{')) {
+        const inner = text.slice(1, text.endsWith('}') ? -1 : undefined);
+        const table = {};
+        for (const pair of splitTop(inner)) {
+            const eq = pair.indexOf('=');
+            if (eq === -1)
+                continue;
+            const value = parseValue(pair.slice(eq + 1));
+            if (value !== undefined)
+                table[key(pair.slice(0, eq))] = value;
+        }
+        return table;
+    }
+    const n = Number(text);
+    return Number.isFinite(n) ? n : text;
+}
+function unquote(text, quote) {
+    const end = text.indexOf(quote, 1);
+    const body = end === -1 ? text.slice(1) : text.slice(1, end);
+    return quote === '"' ? body.replace(/\\(.)/g, (_, c) => (c === 'n' ? '\n' : c === 't' ? '\t' : c)) : body;
+}
+const key = (raw) => raw.trim().replace(/^["']|["']$/g, '');
+/** Splits on commas that are not inside a string, an array or an inline table. */
+function splitTop(text) {
+    const parts = [];
+    let depth = 0;
+    let quote = '';
+    let start = 0;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quote) {
+            if (c === quote && text[i - 1] !== '\\')
+                quote = '';
+        }
+        else if (c === '"' || c === "'")
+            quote = c;
+        else if (c === '[' || c === '{')
+            depth++;
+        else if (c === ']' || c === '}')
+            depth--;
+        else if (c === ',' && depth === 0) {
+            parts.push(text.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(text.slice(start));
+    return parts.map((p) => p.trim()).filter(Boolean);
+}
+/** Splits a dotted table header into its segments, respecting quotes. */
+function path(header) {
+    return splitDots(header).map(key);
+}
+function splitDots(text) {
+    const parts = [];
+    let quote = '';
+    let start = 0;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quote) {
+            if (c === quote)
+                quote = '';
+        }
+        else if (c === '"' || c === "'")
+            quote = c;
+        else if (c === '.') {
+            parts.push(text.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(text.slice(start));
+    return parts;
+}
+/** The whole file, as nested plain objects. Arrays of tables are not supported. */
+export function parseToml(text) {
+    const root = {};
+    let table = root;
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        if (trimmed.startsWith('[')) {
+            const header = trimmed.slice(1, trimmed.indexOf(']') === -1 ? undefined : trimmed.indexOf(']'));
+            if (header.startsWith('['))
+                continue; // array of tables: not needed here
+            table = root;
+            for (const segment of path(header)) {
+                const next = table[segment];
+                if (next && typeof next === 'object' && !Array.isArray(next))
+                    table = next;
+                else
+                    table = (table[segment] = {});
+            }
+            continue;
+        }
+        const eq = trimmed.indexOf('=');
+        if (eq === -1)
+            continue;
+        const value = parseValue(stripComment(trimmed.slice(eq + 1)));
+        if (value !== undefined)
+            table[key(trimmed.slice(0, eq))] = value;
+    }
+    return root;
+}
+/** Drops a trailing `# comment`, unless the `#` is inside a string. */
+function stripComment(text) {
+    let quote = '';
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (quote) {
+            if (c === quote && text[i - 1] !== '\\')
+                quote = '';
+        }
+        else if (c === '"' || c === "'")
+            quote = c;
+        else if (c === '#')
+            return text.slice(0, i);
+    }
+    return text;
+}
+//# sourceMappingURL=toml.js.map

package/dist/toml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.js","sourceRoot":"","sources":["../src/toml.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The shapes everything else passes around.  [PURE]
+ *
+ * Deliberately looser than the MCP schema: a server is free to send fields
+ * this tool has never heard of, and the point is to weigh what arrives, not
+ * to validate it. Anything unrecognised still counts toward the bill.
+ */
+/** How a server is reached. */
+export type Transport = 'stdio' | 'http';
+/** One server, as some client's config file describes it. */
+export type ServerSpec = {
+    /** The name the config gave it — this is what tool names are prefixed with. */
+    name: string;
+    /** Which client's config this came from: `claude-code`, `cursor`, `codex`, `vscode`, `windsurf`. */
+    client: string;
+    /** Where that config lives, so a report can say which file to edit. */
+    source: string;
+    /** `user` for a machine-wide config, `project` for one inside the repo. */
+    scope: 'user' | 'project';
+    transport: Transport;
+    /** stdio only. */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    /** http only. */
+    url?: string;
+    headers?: Record<string, string>;
+    /** Some clients can carry a server while leaving it switched off. */
+    enabled: boolean;
+    /**
+     * Every client whose config carries this same server.
+     *
+     * The same command appears in two or three configs more often than not, and
+     * it costs the same in each, so it is weighed once and the report names the
+     * files rather than billing it twice.
+     */
+    carriedBy: string[];
+};
+/** A tool as the server declares it, and as the model will be shown it. */
+export type ToolDef = {
+    name: string;
+    description?: string;
+    /** JSON Schema. Kept as-is: its size is the whole subject. */
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    annotations?: unknown;
+};
+export type PromptDef = {
+    name: string;
+    description?: string;
+    arguments?: unknown;
+};
+export type ResourceDef = {
+    uri?: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+};
+/** What one server turned out to be carrying. */
+export type Inventory = {
+    server: ServerSpec;
+    tools: ToolDef[];
+    prompts: PromptDef[];
+    resources: ResourceDef[];
+    /** Server name and version from `initialize`, when it gave one. */
+    title?: string;
+    /** How long the handshake and listing took, in milliseconds. */
+    ms: number;
+    /** Set when the server could not be reached or refused to speak. */
+    error?: string;
+};
+/** A tool weighed: what it costs, and whether anyone has used it. */
+export type WeighedTool = {
+    /** The bare name the server gave. */
+    name: string;
+    /** The name a client shows the model, e.g. `mcp__github__create_issue`. */
+    qualified: string;
+    tokens: number;
+    /** Times it was called in the transcripts that were read, or `null` when none were. */
+    calls: number | null;
+};
+export type WeighedServer = {
+    server: ServerSpec;
+    title?: string;
+    tools: WeighedTool[];
+    /** Tokens for the tool definitions alone. */
+    tokens: number;
+    prompts: number;
+    resources: number;
+    ms: number;
+    error?: string;
+};

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * The shapes everything else passes around.  [PURE]
+ *
+ * Deliberately looser than the MCP schema: a server is free to send fields
+ * this tool has never heard of, and the point is to weigh what arrives, not
+ * to validate it. Anything unrecognised still counts toward the bill.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/usage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Which tools anyone actually called.
+ *
+ * The token cost of a tool definition is paid on every request whether or not
+ * the tool is ever used, and that is the whole argument of this program — but
+ * it is only an argument once you can see the other half of the ledger. So the
+ * session transcripts are read for `tool_use` blocks, and each MCP tool gets a
+ * count of the times it was reached for.
+ *
+ * Only Claude Code keeps transcripts in a documented place, so only its
+ * sessions are read. When there are none, every count is `null` — unknown,
+ * which the report is careful never to print as zero.
+ */
+/** What the transcripts said, or nothing at all. */
+export type Usage = {
+    /** Qualified tool name (`mcp__server__tool`) to times called. */
+    calls: Map<string, number>;
+    /** Transcript files read. */
+    sessions: number;
+    /** How far back the read went, in days. */
+    days: number;
+};
+/** How many days of transcripts to read by default. */
+export declare const DEFAULT_DAYS = 30;
+/**
+ * A tool call, from one line of a transcript.
+ *
+ * Exported for its own sake: the line is a whole assistant turn and can be
+ * megabytes of text, so it is only parsed when the marker is present, and
+ * `tool_use` blocks are the only thing taken from it. A `tool_result` echoing
+ * the same name must not count as a second call.
+ */
+export declare function callsInLine(line: string): string[];
+/**
+ * Read the transcripts and count the calls.
+ *
+ * Files untouched since the cutoff are skipped by their timestamp rather than
+ * opened — a year of sessions is a lot of lines, and the last month is what a
+ * decision about today's config rests on.
+ */
+export declare function readUsage(days?: number, home?: string): Promise<Usage | null>;
+/** A lookup that answers `null` — unknown — rather than zero when nothing was read. */
+export declare function lookup(usage: Usage | null): (qualified: string) => number | null;

package/dist/usage.js

@@ -0,0 +1,119 @@
+/**
+ * Which tools anyone actually called.
+ *
+ * The token cost of a tool definition is paid on every request whether or not
+ * the tool is ever used, and that is the whole argument of this program — but
+ * it is only an argument once you can see the other half of the ledger. So the
+ * session transcripts are read for `tool_use` blocks, and each MCP tool gets a
+ * count of the times it was reached for.
+ *
+ * Only Claude Code keeps transcripts in a documented place, so only its
+ * sessions are read. When there are none, every count is `null` — unknown,
+ * which the report is careful never to print as zero.
+ */
+import { createReadStream } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+/** How many days of transcripts to read by default. */
+export const DEFAULT_DAYS = 30;
+/**
+ * A tool call, from one line of a transcript.
+ *
+ * Exported for its own sake: the line is a whole assistant turn and can be
+ * megabytes of text, so it is only parsed when the marker is present, and
+ * `tool_use` blocks are the only thing taken from it. A `tool_result` echoing
+ * the same name must not count as a second call.
+ */
+export function callsInLine(line) {
+    if (!line.includes('mcp__'))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    const walk = (node, depth) => {
+        if (depth > 8 || !node || typeof node !== 'object')
+            return;
+        if (Array.isArray(node)) {
+            for (const item of node)
+                walk(item, depth + 1);
+            return;
+        }
+        const record = node;
+        if (record['type'] === 'tool_use' && typeof record['name'] === 'string' && record['name'].startsWith('mcp__')) {
+            found.push(record['name']);
+        }
+        for (const value of Object.values(record))
+            walk(value, depth + 1);
+    };
+    walk(parsed, 0);
+    return found;
+}
+/**
+ * Every `.jsonl` under a directory, one level of nesting or ten.
+ *
+ * The directory a `Dirent` came from is `parentPath` on Node 20.12 and after,
+ * and was `path` before it. Both are read, because getting this wrong does not
+ * fail — it silently reads nothing and reports every tool as never called.
+ */
+async function transcripts(root) {
+    try {
+        const entries = await readdir(root, { recursive: true, withFileTypes: true });
+        return entries
+            .filter((e) => e.isFile() && e.name.endsWith('.jsonl'))
+            .map((e) => join(e.parentPath ?? e.path ?? root, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read the transcripts and count the calls.
+ *
+ * Files untouched since the cutoff are skipped by their timestamp rather than
+ * opened — a year of sessions is a lot of lines, and the last month is what a
+ * decision about today's config rests on.
+ */
+export async function readUsage(days = DEFAULT_DAYS, home = homedir()) {
+    const files = await transcripts(join(home, '.claude', 'projects'));
+    if (files.length === 0)
+        return null;
+    const cutoff = Date.now() - days * 86_400_000;
+    const calls = new Map();
+    let sessions = 0;
+    for (const file of files) {
+        try {
+            const info = await stat(file);
+            if (info.mtimeMs < cutoff)
+                continue;
+        }
+        catch {
+            continue;
+        }
+        sessions++;
+        try {
+            const lines = createInterface({ input: createReadStream(file, 'utf8'), crlfDelay: Infinity });
+            for await (const line of lines) {
+                for (const name of callsInLine(line))
+                    calls.set(name, (calls.get(name) ?? 0) + 1);
+            }
+        }
+        catch {
+            // A half-written transcript from a live session; what was read still counts.
+        }
+    }
+    return { calls, sessions, days };
+}
+/** A lookup that answers `null` — unknown — rather than zero when nothing was read. */
+export function lookup(usage) {
+    if (!usage)
+        return () => null;
+    return (qualified) => usage.calls.get(qualified) ?? 0;
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"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"}

package/dist/weigh.d.ts

@@ -0,0 +1,41 @@
+/**
+ * What a server's listing is worth, in tokens.  [PURE]
+ *
+ * A tool does not reach the model as the server wrote it. The client renames
+ * it — `mcp__github__create_issue` rather than `create_issue` — and sends the
+ * name, the description and the input schema as one JSON object per tool, on
+ * every single request. That serialized form is what this weighs, because
+ * that is what is actually paid for, turn after turn, whether or not the tool
+ * is ever called.
+ */
+import type { Inventory, ToolDef, WeighedServer, WeighedTool } from './types.ts';
+/** The name a client shows the model. The separator is `__` across all of them. */
+export declare function qualify(server: string, tool: string): string;
+/**
+ * A tool as the request carries it.
+ *
+ * `input_schema` rather than `inputSchema`: the wire format between client and
+ * server is camelCase, the one between client and model is snake_case, and the
+ * second is the one being billed.
+ */
+export declare function serialize(tool: ToolDef, qualified: string): string;
+export declare function weighTool(tool: ToolDef, serverName: string, calls: number | null): WeighedTool;
+/**
+ * The whole listing, weighed.
+ *
+ * Prompts and resources are counted but kept apart from the total: most
+ * clients list them lazily and only a few put them in the system prompt, so
+ * folding them into one number would overstate what every turn costs. The
+ * report shows them as a separate line.
+ */
+export declare function weigh(inv: Inventory, callsOf: (qualified: string) => number | null): WeighedServer;
+/** Servers first by what they cost, then by name, so a report is stable run to run. */
+export declare function heaviestFirst(servers: WeighedServer[]): WeighedServer[];
+export declare const totalTokens: (servers: readonly WeighedServer[]) => number;
+/**
+ * Tools that were paid for and never called.
+ *
+ * `calls === null` means no transcript was read, which is not the same as zero
+ * and is never reported as waste.
+ */
+export declare function unused(servers: readonly WeighedServer[]): WeighedTool[];

package/dist/weigh.js

@@ -0,0 +1,79 @@
+/**
+ * What a server's listing is worth, in tokens.  [PURE]
+ *
+ * A tool does not reach the model as the server wrote it. The client renames
+ * it — `mcp__github__create_issue` rather than `create_issue` — and sends the
+ * name, the description and the input schema as one JSON object per tool, on
+ * every single request. That serialized form is what this weighs, because
+ * that is what is actually paid for, turn after turn, whether or not the tool
+ * is ever called.
+ */
+import { estimate, TOOL_FRAMING } from "./tokens.js";
+/** The name a client shows the model. The separator is `__` across all of them. */
+export function qualify(server, tool) {
+    return `mcp__${server.replace(/[^A-Za-z0-9_-]/g, '_')}__${tool}`;
+}
+/**
+ * A tool as the request carries it.
+ *
+ * `input_schema` rather than `inputSchema`: the wire format between client and
+ * server is camelCase, the one between client and model is snake_case, and the
+ * second is the one being billed.
+ */
+export function serialize(tool, qualified) {
+    return JSON.stringify({
+        name: qualified,
+        description: tool.description ?? '',
+        input_schema: tool.inputSchema ?? { type: 'object', properties: {} },
+    });
+}
+export function weighTool(tool, serverName, calls) {
+    const qualified = qualify(serverName, tool.name);
+    return {
+        name: tool.name,
+        qualified,
+        tokens: estimate(serialize(tool, qualified)) + TOOL_FRAMING,
+        calls,
+    };
+}
+/**
+ * The whole listing, weighed.
+ *
+ * Prompts and resources are counted but kept apart from the total: most
+ * clients list them lazily and only a few put them in the system prompt, so
+ * folding them into one number would overstate what every turn costs. The
+ * report shows them as a separate line.
+ */
+export function weigh(inv, callsOf) {
+    const tools = inv.tools.map((t) => weighTool(t, inv.server.name, callsOf(qualify(inv.server.name, t.name))));
+    return {
+        server: inv.server,
+        title: inv.title,
+        tools: tools.sort((a, b) => b.tokens - a.tokens),
+        tokens: tools.reduce((n, t) => n + t.tokens, 0),
+        prompts: inv.prompts.length,
+        resources: inv.resources.length,
+        ms: inv.ms,
+        error: inv.error,
+    };
+}
+/** Servers first by what they cost, then by name, so a report is stable run to run. */
+export function heaviestFirst(servers) {
+    return servers
+        .slice()
+        .sort((a, b) => b.tokens - a.tokens || a.server.name.localeCompare(b.server.name));
+}
+export const totalTokens = (servers) => servers.reduce((n, s) => n + s.tokens, 0);
+/**
+ * Tools that were paid for and never called.
+ *
+ * `calls === null` means no transcript was read, which is not the same as zero
+ * and is never reported as waste.
+ */
+export function unused(servers) {
+    return servers
+        .flatMap((s) => s.tools)
+        .filter((t) => t.calls === 0)
+        .sort((a, b) => b.tokens - a.tokens);
+}
+//# sourceMappingURL=weigh.js.map

package/dist/weigh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weigh.js","sourceRoot":"","sources":["../src/weigh.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "mcp-baggage",
+  "version": "0.1.0",
+  "description": "What each MCP server carries into your context window, and how much of it you actually use.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "context-window",
+    "tokens",
+    "claude-code",
+    "cursor",
+    "codex",
+    "cli"
+  ],
+  "homepage": "https://github.com/mtalhasahin/mcp-baggage#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mtalhasahin/mcp-baggage.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mtalhasahin/mcp-baggage/issues"
+  },
+  "license": "MIT",
+  "author": "mtalhasahin",
+  "type": "module",
+  "bin": {
+    "mcp-baggage": "dist/bin.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.10"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "test": "node --test \"tests/*.test.ts\"",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}