@dsgraph/mcp 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Reznik
+
+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

@@ -1,3 +1,63 @@
-# Temporary Holding Version
+# @dsgraph/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An MCP server that gives coding agents (Claude Code, Cursor and other MCP clients) the design tokens of your project. Its main job: when an agent is about to write `#3366ff` or `12px` in code, it asks which token holds that value and uses the token instead.
+
+It reads DTCG 2025.10 (with resolver documents and themes), token JSON with `value` and `type` (including token sets and themes), and CSS custom properties, from a folder, an npm package or a GitHub repository. Every tool only reads.
+
+## Install
+
+Step-by-step setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex, with the exact snippet for your tokens: [specsure.app/tools/mcp](https://specsure.app/tools/mcp).
+
+Claude Code, with the project's tokens in `./tokens`:
+
+```bash
+claude mcp add dsgraph -- npx -y @dsgraph/mcp ./tokens
+```
+
+Any other MCP client, in its JSON config:
+
+```json
+{
+  "mcpServers": {
+    "dsgraph": { "command": "npx", "args": ["-y", "@dsgraph/mcp", "./tokens"] }
+  }
+}
+```
+
+The argument is the default source: a folder or file, `npm:@scope/tokens@2` or `github:owner/repo/tokens@main`. Without it the server reads the current folder. A `dsgraph.config.json` in the folder the server starts in is used too (`--config` points elsewhere).
+
+## Tools
+
+| Tool | What it answers |
+|---|---|
+| `find_token` | Which token holds this color, size, duration or font weight? Exact matches first, semantic tokens before the primitives they point to; otherwise the closest values (colors by ΔE, sizes in px across px and rem) |
+| `get_token` | One token: its value in every theme, the references it takes the value from, the tokens that use it, description, deprecation, file |
+| `search_tokens` | Tokens by part of the name or a glob (`color.text.*`) and by type, with their values |
+| `describe_tokens` | An overview: tokens per type, themes and other modes, top-level groups, files |
+| `compare_versions` | What changed between two versions, what breaks and which semver bump the release needs |
+| `check_tokens` | Broken references, cycles, legacy syntax, naming collisions, ramps out of order, colors out of gamut |
+
+Each tool takes an optional `source`, so an agent can also look at a package before upgrading it: "compare `npm:@scope/tokens@2` with `npm:@scope/tokens@3`".
+
+Local files are read again on every call, so the answers follow your edits. Remote sources pinned to an exact version are cached for the session; others for five minutes.
+
+## Example
+
+```
+find_token { "value": "#3366ff" }
+
+color #3366ff in theme: default:
+- #3366ff — exact: `color-accent` → color-blue-500, `color-blue-500`
+
+Use `color-accent` instead of the literal value, or another token with the same value whose name fits the use.
+
+find_token { "value": "0.875rem" }
+
+dimension 0.875rem in theme: default:
+- 16px — off by 2: `space-md`
+- 8px — off by 6: `space-small`
+
+No token matches exactly; the closest is `space-md`. Using a literal value here would bypass the design system.
+```
+
+Part of [dsgraph](https://github.com/specsure/specsure). MIT license.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { loadConfig } from '@dsgraph/cli';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const HELP = `dsgraph-mcp — MCP server for design tokens
+
+Usage
+  dsgraph-mcp [source]
+
+  source   the project's tokens: a folder or file (default .), npm:pkg@version
+           or github:owner/repo/path@ref. Tools accept another source per call.
+
+Options
+  -c, --config <file>   dsgraph.config.json (default: ./dsgraph.config.json if present)
+  -h, --help
+
+Claude Code
+  claude mcp add dsgraph -- npx -y @dsgraph/mcp ./tokens
+`;
+const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: { config: { type: 'string', short: 'c' }, help: { type: 'boolean', short: 'h' } },
+});
+if (values.help) {
+    process.stdout.write(HELP);
+    process.exit(0);
+}
+const cwd = process.cwd();
+const server = createServer({
+    source: positionals[0] ?? process.env.DSGRAPH_SOURCE ?? '.',
+    cwd,
+    config: await loadConfig(values.config, cwd),
+});
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,IAAI,GAAG;;;;;;;;;;;;;;CAcZ,CAAA;AAED,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACxC,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;CAC3F,CAAC,CAAA;AACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;AACzB,MAAM,MAAM,GAAG,YAAY,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG;IAC3D,GAAG;IACH,MAAM,EAAE,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAC7C,CAAC,CAAA;AACF,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAA"}

package/dist/nearest.d.ts

@@ -0,0 +1,23 @@
+import { type DsGraph, type Input, type Token } from '@dsgraph/core';
+/** A value typed by an agent (`#3366ff`, `12px`, `0.5rem`, `600`, `200ms`) as a DTCG type and canonical value. */
+export declare function parseValue(text: string, type?: string): {
+    type: string;
+    value: unknown;
+} | undefined;
+export interface Match {
+    token: Token;
+    value: unknown;
+    distance: number;
+    /** Within the threshold people cannot tell apart (ΔE < 1, < 0.5px). */
+    exact: boolean;
+}
+/**
+ * Tokens nearest to a value in one context. Deprecated ones go last; among equally close tokens,
+ * the ones that reference another token (semantic tokens, which follow themes) come before the
+ * primitives that hold the value.
+ */
+export declare function nearest(graph: DsGraph, parsed: {
+    type: string;
+    value: unknown;
+}, input: Input, limit: number): Match[];
+//# sourceMappingURL=nearest.d.ts.map

package/dist/nearest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nearest.d.ts","sourceRoot":"","sources":["../src/nearest.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,OAAO,EAEZ,KAAK,KAAK,EACV,KAAK,KAAK,EAEX,MAAM,eAAe,CAAA;AAEtB,kHAAkH;AAClH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAYpG;AA0BD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,EACxC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,GACZ,KAAK,EAAE,CAoBT"}

package/dist/nearest.js

@@ -0,0 +1,67 @@
+import { cssValueToToken } from '@dsgraph/adapters';
+import { canonicalize, canonicalValue, DiagnosticBag, deltaEOK, toPx, } from '@dsgraph/core';
+/** A value typed by an agent (`#3366ff`, `12px`, `0.5rem`, `600`, `200ms`) as a DTCG type and canonical value. */
+export function parseValue(text, type) {
+    const entry = cssValueToToken(type ? `--${type}` : '--value', text);
+    const t = type ?? entry.$type;
+    if (!t || t === 'css-expression')
+        return undefined;
+    const ctx = {
+        strict: false,
+        allowNonstandardUnits: true,
+        diag: new DiagnosticBag(),
+        flags: new Set(),
+    };
+    const value = canonicalValue(t, t === entry.$type ? entry.$value : text, ctx);
+    return value === undefined ? undefined : { type: t, value };
+}
+const REM = 16;
+/** How far two values of a type are apart, in the unit people think in; undefined when not comparable. */
+function distance(type, a, b) {
+    if (type === 'color')
+        return deltaEOK(a, b);
+    if (type === 'dimension') {
+        const pa = toPx(a, REM);
+        const pb = toPx(b, REM);
+        if (pa !== undefined && pb !== undefined)
+            return Math.abs(pa - pb);
+    }
+    if (type === 'duration') {
+        const ms = (d) => (d.unit === 's' ? d.value * 1000 : d.value);
+        return Math.abs(ms(a) - ms(b));
+    }
+    if (typeof a === 'number' && typeof b === 'number')
+        return Math.abs(a - b);
+    return canonicalize(a) === canonicalize(b) ? 0 : undefined;
+}
+/** Types an agent's value can stand for: a bare number may be a font weight. */
+const COMPATIBLE = {
+    number: ['number', 'fontWeight'],
+    fontWeight: ['fontWeight', 'number'],
+};
+/**
+ * Tokens nearest to a value in one context. Deprecated ones go last; among equally close tokens,
+ * the ones that reference another token (semantic tokens, which follow themes) come before the
+ * primitives that hold the value.
+ */
+export function nearest(graph, parsed, input, limit) {
+    const types = COMPATIBLE[parsed.type] ?? [parsed.type];
+    const out = [];
+    for (const token of graph.tokens({ type: types })) {
+        const value = graph.value(token.id, input);
+        if (value === undefined || value === null)
+            continue;
+        const d = distance(token.type === parsed.type ? parsed.type : token.type, parsed.value, value);
+        if (d === undefined)
+            continue;
+        const exact = parsed.type === 'color' ? d < 1 : parsed.type === 'dimension' ? d < 0.5 : d === 0;
+        out.push({ token, value, distance: Math.round(d * 100) / 100, exact });
+    }
+    return out
+        .sort((a, b) => Number(a.token.deprecated !== null) - Number(b.token.deprecated !== null) ||
+        a.distance - b.distance ||
+        graph.chain(b.token.id, input).length - graph.chain(a.token.id, input).length ||
+        a.token.id.localeCompare(b.token.id))
+        .slice(0, limit);
+}
+//# sourceMappingURL=nearest.js.map

package/dist/nearest.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { type Config } from '@dsgraph/core';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface ServerOptions {
+    /** The design system the tools read when a call names no source: a folder, a file, `npm:…` or `github:…`. */
+    source: string;
+    /** Folder that relative sources and `dsgraph.config.json` are resolved against. */
+    cwd: string;
+    config?: Config;
+    version?: string;
+}
+/** The MCP server: read-only tools over a design system's tokens, built on dsgraph. */
+export declare function createServer(opts: ServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAA8C,MAAM,eAAe,CAAA;AAIvF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAInE,MAAM,WAAW,aAAa;IAC5B,6GAA6G;IAC7G,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA+BD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAkR3D"}

package/dist/server.js

@@ -0,0 +1,259 @@
+import { diffOptions, loadGraph } from '@dsgraph/cli';
+import { diff } from '@dsgraph/core';
+import { formatChangeset, formatFindings, formatValue, formatWhen } from '@dsgraph/report';
+import { check } from '@dsgraph/rules';
+import { parseRemoteSpec } from '@dsgraph/sources';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { nearest, parseValue } from './nearest.js';
+const SOURCE = z
+    .string()
+    .optional()
+    .describe('Where the tokens are: a folder or file path, npm:package@version or github:owner/repo/path@ref. Leave out for the project default.');
+const CONTEXT = z
+    .record(z.string(), z.string())
+    .optional()
+    .describe('Theme or other mode to read values in, e.g. {"theme": "dark"}. Leave out for the default.');
+/** Remote sources pinned to an exact version never change; everything else is read again after a while. */
+const pinned = (spec) => {
+    const r = parseRemoteSpec(spec);
+    if (!r)
+        return false;
+    return r.kind === 'npm' ? /^\d+\.\d+\.\d+/.test(r.version) : /^[0-9a-f]{40}$/.test(r.ref);
+};
+const REMOTE_TTL = 5 * 60_000;
+const text = (t) => ({ content: [{ type: 'text', text: t }] });
+const failure = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
+function describeValue(graph, t, input) {
+    const v = graph.value(t.id, input);
+    const chain = graph.chain(t.id, input);
+    const alias = chain.length > 1 ? ` (alias of ${chain.slice(1).join(' → ')})` : '';
+    return `${formatValue(t.type, v)}${alias}`;
+}
+/** The MCP server: read-only tools over a design system's tokens, built on dsgraph. */
+export function createServer(opts) {
+    const server = new McpServer({ name: 'dsgraph', version: opts.version ?? '0.2.0' });
+    const config = opts.config ?? {};
+    const cache = new Map();
+    const graphOf = (source) => {
+        const spec = source?.trim() || opts.source;
+        const remote = !!parseRemoteSpec(spec);
+        const hit = cache.get(spec);
+        // Local files change while the agent works: read them on every call.
+        if (hit && remote && (pinned(spec) || Date.now() - hit.at < REMOTE_TTL))
+            return hit.graph;
+        const graph = loadGraph(spec, config, opts.cwd);
+        if (remote) {
+            cache.set(spec, { graph, at: Date.now() });
+            graph.catch(() => cache.delete(spec));
+        }
+        return graph;
+    };
+    const inputOf = (graph, context) => graph.defaultInput(context ?? {});
+    const contextLine = (graph, input) => graph.modifiers.length
+        ? ` in ${Object.entries(input)
+            .map(([k, v]) => `${k}: ${v}`)
+            .join(', ')}`
+        : '';
+    server.registerTool('find_token', {
+        title: 'Find the token for a value',
+        description: 'Use before writing a hard-coded color, size, duration or font weight in code: returns the design tokens whose value matches it or comes closest (colors by visual difference ΔE, sizes in px). Prefer an exact match; among exact matches, semantic tokens (aliases) are listed before the primitives they point to.',
+        inputSchema: {
+            value: z
+                .string()
+                .describe('The value, e.g. "#3366ff", "rgb(51 102 255)", "12px", "0.75rem", "600", "200ms"'),
+            type: z
+                .enum(['color', 'dimension', 'duration', 'number', 'fontWeight', 'fontFamily', 'cubicBezier'])
+                .optional()
+                .describe('Token type, when the value alone is ambiguous'),
+            context: CONTEXT,
+            limit: z.number().int().min(1).max(25).optional().describe('How many tokens to return (default 5)'),
+            source: SOURCE,
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ value, type, context, limit, source }) => {
+        const parsed = parseValue(value, type);
+        if (!parsed)
+            return failure(`"${value}" is not a value dsgraph can read as a token value. Pass \`type\` if it is ambiguous.`);
+        const graph = await graphOf(source);
+        const input = inputOf(graph, context);
+        // Tokens with the same value are one choice: grouped, so the list shows different values.
+        const groups = [];
+        for (const m of nearest(graph, parsed, input, 500)) {
+            const key = formatValue(m.token.type, m.value);
+            const g = groups.find((x) => x.value === key);
+            if (g)
+                g.matches.push(m);
+            else if (groups.length < (limit ?? 5))
+                groups.push({ value: key, matches: [m] });
+        }
+        if (!groups.length)
+            return text(`No ${parsed.type} tokens${contextLine(graph, input)}.`);
+        const lines = groups.map(({ value: v, matches }) => {
+            const first = matches[0];
+            const how = first.exact
+                ? 'exact'
+                : parsed.type === 'color'
+                    ? `ΔE ${first.distance}`
+                    : `off by ${first.distance}`;
+            const shown = matches.slice(0, 4).map((m) => {
+                const chain = graph.chain(m.token.id, input);
+                const alias = chain.length > 1 ? ` → ${chain.at(-1)}` : '';
+                return `\`${m.token.id}\`${alias}${m.token.deprecated ? ' (deprecated)' : ''}`;
+            });
+            const more = matches.length > 4 ? `, and ${matches.length - 4} more` : '';
+            return `- ${v} — ${how}: ${shown.join(', ')}${more}`;
+        });
+        const best = groups[0].matches[0];
+        const advice = best.exact
+            ? `Use \`${best.token.id}\` instead of the literal value${groups[0].matches.length > 1 ? ', or another token with the same value whose name fits the use' : ''}.`
+            : `No token matches exactly; the closest is \`${best.token.id}\`. Using a literal value here would bypass the design system.`;
+        return text(`${parsed.type} ${formatValue(parsed.type, parsed.value)}${contextLine(graph, input)}:\n${lines.join('\n')}\n\n${advice}`);
+    });
+    server.registerTool('get_token', {
+        title: 'Read a token',
+        description: 'One token in full: its value in every theme, the chain of references it takes the value from, the tokens that use it, its description, deprecation and file.',
+        inputSchema: {
+            id: z
+                .string()
+                .describe('Token id as dsgraph writes it, e.g. "color.text.primary" or "space-4" for CSS'),
+            source: SOURCE,
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ id, source }) => {
+        const graph = await graphOf(source);
+        const t = graph.token(id);
+        if (!t) {
+            const near = graph
+                .tokens()
+                .map((x) => x.id)
+                .filter((x) => x.includes(id) || id.includes(x))
+                .slice(0, 8);
+            return failure(`No token "${id}".${near.length ? ` Similar: ${near.map((n) => `\`${n}\``).join(', ')}` : ''}`);
+        }
+        const lines = [`\`${t.id}\` — ${t.type ?? 'untyped'}`];
+        if (t.description)
+            lines.push(t.description);
+        if (t.deprecated)
+            lines.push(`Deprecated${t.deprecated.replacement ? `: use \`${t.deprecated.replacement}\`` : t.deprecated.reason ? `: ${t.deprecated.reason}` : ''}.`);
+        lines.push('', 'Values:');
+        for (const v of t.values) {
+            const chain = graph.chain(t.id, v.when);
+            const via = chain.length > 1 ? ` ← ${chain.slice(1).join(' ← ')}` : '';
+            lines.push(`- ${formatWhen(v.when).replace(/^ \(|\)$/g, '') || 'everywhere'}: ${formatValue(t.type, v.value)}${via}`);
+        }
+        const users = graph.dependents(t.id);
+        const all = graph.dependents(t.id, { transitive: true });
+        lines.push('', users.length
+            ? `Used by ${users.length} token${users.length === 1 ? '' : 's'}${all.length > users.length ? ` (${all.length} counting their users)` : ''}: ${users
+                .slice(0, 30)
+                .map((u) => `\`${u}\``)
+                .join(', ')}${users.length > 30 ? ', …' : ''}`
+            : 'No other token uses it.', `File: ${t.origin.file}`);
+        return text(lines.join('\n'));
+    });
+    server.registerTool('search_tokens', {
+        title: 'Search tokens',
+        description: 'Lists tokens by name and type with their values, e.g. every color, or everything under "color.text". Use to learn which tokens exist before choosing one.',
+        inputSchema: {
+            query: z
+                .string()
+                .optional()
+                .describe('Part of the name, or a glob such as "color.text.*". Leave out to list everything (up to the limit).'),
+            type: z
+                .string()
+                .optional()
+                .describe('Only this type: color, dimension, fontFamily, typography, shadow…'),
+            context: CONTEXT,
+            limit: z.number().int().min(1).max(500).optional().describe('Most tokens to return (default 100)'),
+            source: SOURCE,
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ query, type, context, limit, source }) => {
+        const graph = await graphOf(source);
+        const input = inputOf(graph, context);
+        const q = query?.trim() ?? '';
+        const glob = /[*?]/.test(q);
+        const all = graph.tokens(type ? { type } : {}).filter((t) => {
+            if (!q)
+                return true;
+            if (glob)
+                return graph.tokens({ path: q }).some((x) => x.id === t.id);
+            return t.id.toLowerCase().includes(q.toLowerCase());
+        });
+        const max = limit ?? 100;
+        if (!all.length)
+            return text('No tokens match.');
+        const lines = all
+            .slice(0, max)
+            .map((t) => `- \`${t.id}\` (${t.type ?? '?'}): ${describeValue(graph, t, input)}${t.deprecated ? ' — deprecated' : ''}`);
+        if (all.length > max)
+            lines.push(`… ${all.length - max} more; narrow the query or raise the limit.`);
+        return text(`${all.length} token${all.length === 1 ? '' : 's'}${contextLine(graph, input)}:\n${lines.join('\n')}`);
+    });
+    server.registerTool('describe_tokens', {
+        title: 'Describe the design system',
+        description: 'An overview of a token source: how many tokens of each type, the themes and other modes, the top-level groups and files. Start here with an unfamiliar design system.',
+        inputSchema: { source: SOURCE },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ source }) => {
+        const graph = await graphOf(source);
+        const tokens = graph.tokens();
+        const byType = new Map();
+        for (const t of tokens)
+            byType.set(t.type ?? 'untyped', (byType.get(t.type ?? 'untyped') ?? 0) + 1);
+        const roots = new Map();
+        for (const t of tokens) {
+            const root = t.id.includes('.') ? t.id.split('.')[0] : t.id.split('-')[0];
+            roots.set(root, (roots.get(root) ?? 0) + 1);
+        }
+        const files = new Set(tokens.map((t) => t.origin.file));
+        const errors = graph.snapshot.diagnostics.filter((d) => d.severity === 'error').length;
+        const lines = [
+            `${tokens.length} tokens from ${files.size} file${files.size === 1 ? '' : 's'} (${source?.trim() || opts.source}).`,
+            `Types: ${[...byType]
+                .sort((a, b) => b[1] - a[1])
+                .map(([k, n]) => `${k} ${n}`)
+                .join(', ')}.`,
+            graph.modifiers.length
+                ? `Modes: ${graph.modifiers.map((m) => `${m.name} (${m.contexts.join(', ')}; default ${m.default ?? m.contexts[0]})`).join('; ')}.`
+                : 'No themes or other modes.',
+            `Top-level groups: ${[...roots]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 20)
+                .map(([k, n]) => `${k} ${n}`)
+                .join(', ')}.`,
+        ];
+        if (errors)
+            lines.push(`${errors} parse errors; run check_tokens for details.`);
+        return text(lines.join('\n'));
+    });
+    server.registerTool('compare_versions', {
+        title: 'Compare two versions',
+        description: 'What changed between two versions of the tokens, what breaks and which semver bump the release needs: removed and renamed tokens first, value changes per theme, and tokens that changed through references. Use before upgrading a token package or releasing one.',
+        inputSchema: {
+            base: z
+                .string()
+                .describe('The old version: a path, npm:package@version or github:owner/repo/path@ref'),
+            head: SOURCE.describe('The new version; leave out for the project default'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ base, head }) => {
+        const [b, h] = await Promise.all([graphOf(base), graphOf(head)]);
+        const cs = await diff(b, h, diffOptions(config));
+        const types = new Map([...b.tokens(), ...h.tokens()].map((t) => [t.id, t.type]));
+        return text(formatChangeset(cs, { format: 'markdown', types }));
+    });
+    server.registerTool('check_tokens', {
+        title: 'Check tokens',
+        description: 'Problems in a token source: broken references, reference cycles, legacy syntax, naming collisions, color ramps out of order, colors out of gamut. Repeated problems are grouped.',
+        inputSchema: { source: SOURCE },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ source }) => {
+        const graph = await graphOf(source);
+        const findings = await check(graph, config);
+        return text(findings.length ? formatFindings(findings, { format: 'markdown' }) : 'No problems found.');
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@dsgraph/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "MCP server for design tokens: find the token for a value, read a token with its references, compare versions, run checks. DTCG, token JSON and CSS; folders, npm and GitHub.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "dsgraph-mcp": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/specsure/specsure.git",
+    "directory": "packages/dsgraph-mcp"
+  },
+  "homepage": "https://github.com/specsure/specsure/tree/main/packages/dsgraph-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/specsure/specsure/issues"
+  },
+  "keywords": [
+    "design-tokens",
+    "dtcg",
+    "design-system",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "engines": {
+    "node": ">=20.19"
+  },
+  "dependencies": {
+    "@dsgraph/adapters": "0.2.0",
+    "@dsgraph/cli": "0.2.0",
+    "@dsgraph/core": "0.2.0",
+    "@dsgraph/report": "0.2.0",
+    "@dsgraph/rules": "0.2.0",
+    "@dsgraph/sources": "0.2.0",
+    "@modelcontextprotocol/sdk": "1.31.0",
+    "zod": "4.6.5"
+  }
+}