{ "name": "tokapps-tdm-mcp", "version": "0.2.2", "description": "Tokapps Design System MCP — tokens, components, patterns, themes, docs and validators for agents (build-time only).", "transport": "stdio", "command": { "command": "npx", "args": [ "tsx", "packages/tdm-mcp/src/server.ts" ] }, "buildTimeOnly": true, "warning": "Dev/build tooling only. Never run or expose this server in production.", "themeControllableTokens": [ "--tds-accent-hue", "--tds-accent-chroma", "--tds-radius-scale", "--tds-font-weight-heading", "--tds-density-scale", "--tds-motion-emphasis" ], "capabilities": { "logging": {}, "resources": { "listChanged": true }, "tools": { "listChanged": true } }, "tools": [ { "name": "search_design_guidance", "description": "Ranked keyword search (Persian + English) over docs/*.md, AGENTS.md sections, semantic tokens and themes. Use first to find rules and philosophy before designing.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "description": "Free text, Persian or English" }, "limit": { "type": "integer", "minimum": 1, "maximum": 25, "default": 8 }, "kinds": { "type": "array", "items": { "type": "string", "enum": [ "doc", "component", "primitive", "pattern", "token", "theme" ] }, "description": "Restrict result kinds (default: doc, token, theme)" } }, "required": [ "query" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "search_components", "description": "Ranked search over component, primitive and pattern metadata (*.metadata.json). Returns an empty list with a hint when no metadata exists yet.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1 }, "limit": { "type": "integer", "minimum": 1, "maximum": 25, "default": 8 }, "kind": { "type": "string", "enum": [ "any", "component", "primitive", "pattern" ], "default": "any" } }, "required": [ "query" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_component", "description": "Full description of one component or primitive: metadata, source file list and the semantic tokens it declares. Name is case-insensitive (Button, button, ResponsiveDialog, responsive-dialog).", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 } }, "required": [ "name" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_component_code", "description": "Source code of a component/primitive/pattern (tsx/css by default; include=\"all\" adds types, docs, examples). Output is capped at ~60KB; larger files are listed without content. Read-only: never edit these files.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "include": { "type": "string", "enum": [ "main", "all" ], "default": "main" }, "files": { "type": "array", "items": { "type": "string" }, "description": "Exact file names to return, e.g. [\"Button.tsx\"]" } }, "required": [ "name" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_component_metadata", "description": "Raw *.metadata.json of a component, primitive or pattern (props, variants, a11y, tokens, usage rules).", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 } }, "required": [ "name" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_pattern", "description": "Layer-4 pattern (e.g. IdeaSubmission, AuthFlow): metadata, composition and code. If no pattern metadata exists yet, returns the planned pattern list from AGENTS.md instead of failing.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "withCode": { "type": "boolean", "default": false } }, "required": [ "name" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_tokens", "description": "Design tokens from the CSS source of truth. Semantic tokens (layer=semantic) include semanticRole, allowedOn, contrastTarget and supportsThemes. Filter by layer, name prefix, semantic category or free-text query.", "inputSchema": { "type": "object", "properties": { "layer": { "type": "string", "enum": [ "raw", "semantic", "component", "themes", "product-themes" ] }, "prefix": { "type": "string", "description": "CSS variable prefix, e.g. \"--tds-fg\" or \"--tds-space\"" }, "category": { "type": "string", "enum": [ "color", "surface", "border", "shadow", "material", "focus", "radius", "interaction" ], "description": "Semantic category (restricts to semantic tokens)" }, "query": { "type": "string", "description": "Substring of name, path, role or note" }, "limit": { "type": "integer", "minimum": 1, "maximum": 500, "default": 200 } }, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_theme", "description": "Product theme metadata (hue, chroma, radiusScale, headingWeight, density, motion, layout) plus the raw theme CSS. Omit id to list all themes.", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "One of: enterprise, funding, ideation, product-hunt, stories, tokapps" } }, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "create_theme", "description": "GENERATE a new product theme as files without touching shared components: theme.css (only theme-controllable tokens), metadata.json and preview.html. Verifies WCAG contrast (light/dark x normal/high) with the repo token checker; fails if contrast fails. Writes files only when outDir is given (inside the OS tmp dir, or a custom directory that does not overlap packages/*/src); otherwise returns contents only.", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "description": "kebab-case theme id, e.g. \"marketplace\"" }, "nameFa": { "type": "string" }, "description": { "type": "string" }, "hue": { "type": "number", "minimum": 0, "maximum": 360, "description": "OKLCH hue of the accent" }, "chroma": { "type": "number", "minimum": 0, "maximum": 0.37, "default": 0.13, "description": "OKLCH chroma of the accent" }, "radiusScale": { "type": "number", "minimum": 0.5, "maximum": 1.5, "default": 1 }, "headingWeight": { "type": "number", "enum": [ 500, 600, 700 ], "default": 700 }, "density": { "type": "number", "minimum": 0.8, "maximum": 1.2, "default": 1 }, "motion": { "type": "string", "enum": [ "out", "spring", "soft" ], "default": "out" }, "outDir": { "type": "string", "description": "Directory to write //{theme.css,metadata.json,preview.html}" } }, "required": [ "id", "hue" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "validate_rtl", "description": "Static RTL check of JSX/TSX/CSS: physical properties (margin/padding/border left|right, left/right positioning, text-align, float, Tailwind ml-/mr-/pl-/pr-/left-/right-), translateX without direction handling, missing dir=\"auto\" on user content. Returns line numbers and the logical replacement.", "inputSchema": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "description": "JSX/TSX/HTML/CSS source text" }, "filename": { "type": "string" } }, "required": [ "source" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "validate_accessibility", "description": "Static WCAG 2.2 checks of JSX/HTML: img alt, button names, icon-only buttons, click on non-interactive elements, color-only status, outline removal, positive tabindex, heading skips. Issues carry WCAG criterion ids.", "inputSchema": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "description": "JSX/TSX/HTML/CSS source text" }, "filename": { "type": "string" } }, "required": [ "source" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "validate_responsive_behavior", "description": "Static responsive checks: fixed px widths, missing viewport meta, 100vw/100vh, hard-coded breakpoints, touch targets under 44px, horizontal overflow risks.", "inputSchema": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "description": "JSX/TSX/HTML/CSS source text" }, "filename": { "type": "string" } }, "required": [ "source" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }, "annotations": { "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "validate_agent_output", "description": "Final gate before delivery. Rejects changed paths under packages/{tokens,primitives,tuk,patterns,icons,motion,sound,gestures,accessibility}/src, raw colors (hex/rgb/hsl/oklch), gradients (except GradientBorder), non --tds-* or raw-layer tokens, then aggregates RTL, accessibility and responsive validators. Also gates layout rules: dock-required, six slots, ProductDock, identity, dock-search (search key must open a live CommandMenu popup configured through identity.dock.search), dock-apps-bottomsheet (dock apps always open in the dock bottom sheet) and arrival-target (the sign-in arrival must fly the profile image onto the dock account key), plus media-player-kit (audio/podcast playback must use the dock player — the Podcast pattern or playOnDock/dockPlayer; raw