{ "schema_version": "2.0.0", "catalog_version": "2.0.0", "generated_at": "2026-07-18T00:00:00Z", "server_info": { "name": "CodeCrafted Design", "version": "2.4.0" }, "server_capabilities": { "tools": { "listChanged": false }, "resources": { "listChanged": false }, "prompts": { "listChanged": false } }, "protocol": { "target_version": "2025-11-25", "supported_versions": [ "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05" ], "transport": "streamable-http", "endpoint": "https://design.codecrafted.co.uk/mcp", "authentication": "OAuth mcp:use scope or revocable API key abilities", "access": "catalogue reads plus authenticated project and review persistence" }, "server_instructions": "Start with capability status, resume a matching project and complete only material brief decisions. Preview contrasting directions without saving one; for user-led projects, present tradeoffs and persist only the candidate the user explicitly approves. Treat brief routes as authoritative and archetypes as composable grammar across journeys, topologies, navigation models and product zones. Named styles are facet presets. Component contracts separate invariant semantics and behaviour from selectable variant axes: explore material orientation, layout, presentation and interaction tradeoffs in context, then persist only explicit user choices. Keep hard floors separate from contextual budgets and creative guidance. Preserve, adjust with locks or undo approved choices. Implementation review evaluates submitted evidence and never replaces browser, assistive-technology or user testing.", "counts": { "tools": 30, "resources": 7, "resource_templates": 10, "prompts": 2 }, "tools": [ { "name": "adjust_design_direction", "title": "Adjust Design Direction", "description": "Adjust selected direction choices while preserving explicit locks, returning and recording a bounded before/after diff with undo support.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "reason": { "minLength": 3, "maxLength": 1000, "type": "string" }, "changes": { "properties": { "archetype_id": { "type": "string" }, "style_id": { "type": "string" }, "palette_id": { "type": "string" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "selection_mode": { "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "foundation_profile": { "properties": { "density": { "enum": [ "compact", "balanced", "relaxed" ], "type": "string" }, "type_scale": { "enum": [ "compact", "standard", "editorial" ], "type": "string" }, "icon_style": { "enum": [ "outline", "filled", "duotone" ], "type": "string" }, "breakpoint_strategy": { "enum": [ "viewport", "container", "hybrid" ], "type": "string" } }, "type": "object" } }, "type": "object" }, "locks": { "maxItems": 5, "items": { "enum": [ "archetype", "style", "palette", "foundations", "motion" ], "type": "string" }, "uniqueItems": true, "type": "array" }, "unlock_facets": { "maxItems": 7, "items": { "enum": [ "layout", "typography", "color_energy", "material", "imagery", "motion_character", "tone" ], "type": "string" }, "uniqueItems": true, "type": "array" } }, "type": "object", "required": [ "project_id", "reason", "changes" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "audit_design_contract", "title": "Audit Design Contract", "description": "Audit an implementation summary against a versioned CodeCrafted Design composition and release gates.", "inputSchema": { "properties": { "composition_id": { "minLength": 10, "maxLength": 512, "type": "string" }, "implementation_summary": { "description": "Measured implementation evidence; do not invent claims or performance values.", "properties": { "routes": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "sections": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "components": { "maxItems": 300, "items": { "type": "string" }, "type": "array" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "accessibility_claims": { "maxItems": 100, "items": { "type": "string" }, "type": "array" }, "seo": { "properties": { "canonical": { "type": "boolean" }, "single_h1": { "type": "boolean" }, "server_rendered_content": { "type": "boolean" } }, "type": "object", "required": [ "canonical", "single_h1", "server_rendered_content" ] }, "performance_measurements": { "properties": { "lcp_ms": { "minimum": 0, "type": "number" }, "inp_ms": { "minimum": 0, "type": "number" }, "cls": { "minimum": 0, "type": "number" } }, "type": "object", "required": [ "lcp_ms", "inp_ms", "cls" ] }, "detected_anti_patterns": { "maxItems": 50, "items": { "type": "string" }, "type": "array" } }, "type": "object", "required": [ "routes", "sections", "components", "motion_level", "accessibility_claims", "seo", "performance_measurements" ] } }, "type": "object", "required": [ "composition_id", "implementation_summary" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "compare_design_systems", "title": "Compare Design Systems", "description": "Compare two to five viable archetype, style and palette combinations using bounded decision criteria.", "inputSchema": { "properties": { "candidates": { "minItems": 2, "maxItems": 5, "items": { "properties": { "style_id": { "type": "string" }, "archetype_id": { "type": "string" }, "palette_id": { "type": "string" }, "palette_mode": { "default": "auto", "enum": [ "auto", "light", "dark" ], "type": "string" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "preference_score": { "description": "Optional user-supplied preference evidence, not an agent-inferred compliance score.", "minimum": 0, "maximum": 100, "type": "integer" }, "preference_reason": { "maxLength": 500, "type": "string" } }, "type": "object", "required": [ "style_id", "archetype_id" ] }, "type": "array" }, "criteria": { "description": "Relative fit weights; accessibility, performance and motion are reported separately as constraints and risk evidence.", "properties": { "compatibility_weight": { "default": 0.65, "minimum": 0, "maximum": 1, "type": "number" }, "user_preference_weight": { "default": 0.35, "minimum": 0, "maximum": 1, "type": "number" } }, "type": "object" }, "selection_mode": { "default": "balanced", "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "regulatory_profile": { "default": "none", "enum": [ "none", "healthcare", "finance", "government", "education", "children-family", "enterprise-saas" ], "type": "string" } }, "type": "object", "required": [ "candidates" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "compose_design_system", "title": "Compose Design System", "description": "Compose an exact archetype, style and catalogue or generated palette into a versioned implementation contract with release gates.", "inputSchema": { "properties": { "style_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "archetype_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "palette_id": { "pattern": "^(?:p\\d{4}-[a-z0-9]+(?:-[a-z0-9]+)*|custom-[a-z0-9]+)$", "type": "string" }, "palette_recipe": { "description": "Stateless custom recipe. Mutually exclusive with palette_id.", "properties": { "primary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "secondary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "accent_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "harmony": { "default": "auto", "enum": [ "auto", "monochrome", "analogous", "complementary", "split-complementary", "triadic" ], "type": "string" }, "expression": { "default": "balanced", "enum": [ "quiet", "balanced", "vivid", "earthy", "synthetic" ], "type": "string" }, "neutral_temperature": { "default": "neutral", "enum": [ "neutral", "warm", "cool", "seeded" ], "type": "string" }, "lock_primary": { "default": true, "type": "boolean" }, "lock_secondary": { "type": "boolean" }, "lock_accent": { "type": "boolean" } }, "type": "object", "required": [ "primary_seed" ] }, "palette_mode": { "default": "auto", "enum": [ "auto", "light", "dark" ], "type": "string" }, "foundation_profile": { "properties": { "density": { "default": "balanced", "enum": [ "compact", "balanced", "relaxed" ], "type": "string" }, "type_scale": { "default": "standard", "enum": [ "compact", "standard", "editorial" ], "type": "string" }, "icon_style": { "default": "outline", "enum": [ "outline", "filled", "duotone" ], "type": "string" }, "breakpoint_strategy": { "default": "hybrid", "enum": [ "viewport", "container", "hybrid" ], "type": "string" } }, "type": "object" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "accessibility_level": { "minimum": 1, "maximum": 5, "type": "integer" }, "accessibility_profile": { "properties": { "contrast": { "enum": [ "AA", "AAA" ], "type": "string" }, "motion": { "enum": [ "reduced_safe", "static" ], "type": "string" }, "keyboard": { "enum": [ "full" ], "type": "string" }, "screen_reader": { "enum": [ "semantic" ], "type": "string" }, "cognitive_load": { "enum": [ "standard", "low" ], "type": "string" }, "target_size": { "enum": [ "standard", "large" ], "type": "string" } }, "type": "object" }, "performance_profile": { "enum": [ "lean", "standard", "enhanced", "heavy" ], "type": "string" }, "implementation_target": { "default": "framework-neutral", "enum": [ "framework-neutral", "nextjs", "astro", "react", "sveltekit", "plain-html", "laravel-blade", "rails", "django", "phoenix", "server-rendered", "other" ], "type": "string" }, "strict_compatibility": { "default": true, "type": "boolean" }, "selection_mode": { "default": "balanced", "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "regulatory_profile": { "default": "none", "enum": [ "none", "healthcare", "finance", "government", "education", "children-family", "enterprise-saas" ], "type": "string" } }, "type": "object", "required": [ "style_id", "archetype_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "create_design_project", "title": "Create Design Project", "description": "Create a private design project, save an initial brief and return the next discovery questions without inventing missing requirements.", "inputSchema": { "properties": { "name": { "minLength": 2, "maxLength": 120, "type": "string" }, "brief": { "description": "The project discovery context. Incomplete briefs are saved and returned with the next questions to ask.", "properties": { "goal": { "maxLength": 500, "type": "string" }, "audiences": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "primary_actions": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "business_outcomes": { "maxItems": 20, "items": { "maxLength": 200, "type": "string" }, "type": "array" }, "required_pages": { "maxItems": 50, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "required_features": { "maxItems": 50, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "content_status": { "enum": [ "unknown", "missing", "partial", "ready" ], "type": "string" }, "brand_attributes": { "maxItems": 12, "items": { "maxLength": 80, "type": "string" }, "type": "array" }, "locked_colors": { "maxItems": 3, "items": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "type": "array" }, "accessibility_target": { "default": "AA", "enum": [ "AA", "AAA" ], "type": "string" }, "devices": { "maxItems": 12, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "implementation_target": { "default": "framework-neutral", "enum": [ "framework-neutral", "nextjs", "astro", "react", "sveltekit", "plain-html", "laravel-blade", "rails", "django", "phoenix", "server-rendered", "other" ], "type": "string" }, "decision_authority": { "description": "Who has authority to approve a persistent direction. User-led requires explicit user approval.", "default": "user_led", "enum": [ "user_led", "collaborative", "delegated" ], "type": "string" }, "experience_profile": { "default": "balanced", "enum": [ "lean", "balanced", "expressive", "immersive" ], "type": "string" }, "design_preferences": { "properties": { "novelty": { "default": "balanced", "enum": [ "familiar", "balanced", "expressive" ], "type": "string" }, "desired": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "avoid": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "references": { "maxItems": 12, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" }, "structure_preferences": { "properties": { "journeys": { "maxItems": 9, "items": { "enum": [ "discover", "compare", "transact", "learn", "create", "operate", "collaborate", "participate", "experience" ], "type": "string" }, "type": "array" }, "content_topologies": { "maxItems": 9, "items": { "enum": [ "hierarchy", "collection-detail", "graph", "feed", "dataset", "workflow-case", "conversation", "canvas", "spatial" ], "type": "string" }, "type": "array" }, "navigation_models": { "maxItems": 7, "items": { "enum": [ "hierarchical", "hub-spoke", "sequential", "faceted", "contextual", "persistent-workspace", "conversational" ], "type": "string" }, "type": "array" }, "product_zones": { "maxItems": 10, "items": { "enum": [ "public", "discovery", "learning", "service", "product", "account", "admin", "community", "commerce", "immersive" ], "type": "string" }, "type": "array" } }, "type": "object" }, "style_preferences": { "properties": { "facets": { "properties": { "layout": { "maxLength": 80, "type": "string" }, "typography": { "maxLength": 80, "type": "string" }, "color_energy": { "maxLength": 80, "type": "string" }, "material": { "maxLength": 80, "type": "string" }, "imagery": { "maxLength": 80, "type": "string" }, "motion_character": { "maxLength": 80, "type": "string" }, "tone": { "maxLength": 80, "type": "string" } }, "type": "object" }, "locked_facets": { "maxItems": 7, "items": { "enum": [ "layout", "typography", "color_energy", "material", "imagery", "motion_character", "tone" ], "type": "string" }, "type": "array" } }, "type": "object" }, "component_source": { "properties": { "type": { "default": "none", "enum": [ "none", "storybook", "shadcn", "custom" ], "type": "string" }, "reference": { "maxLength": 2048, "type": "string" } }, "type": "object" }, "constraints": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "exclusions": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "evidence": { "maxItems": 50, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object", "required": [ "name", "brief" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "explain_selection", "title": "Explain Selection", "description": "Explain why a chosen archetype, style and palette direction is suitable, including compatibility and safety context.", "inputSchema": { "properties": { "style_id": { "type": "string" }, "archetype_id": { "type": "string" }, "palette_id": { "type": "string" }, "palette_mode": { "default": "auto", "enum": [ "auto", "light", "dark" ], "type": "string" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "selection_mode": { "default": "balanced", "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "regulatory_profile": { "default": "none", "enum": [ "none", "healthcare", "finance", "government", "education", "children-family", "enterprise-saas" ], "type": "string" } }, "type": "object", "required": [ "style_id", "archetype_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "explore_component_variants", "title": "Explore Component Variants", "description": "Explore one component’s orientation, layout, presentation and interaction options in context. Returns neutral tradeoffs and questions; never saves or silently recommends a choice.", "inputSchema": { "properties": { "component_id": { "pattern": "^c\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "selections": { "description": "Optional axis_id to option_id choices to preview; unspecified axes retain labelled catalogue starting points.", "type": "object" }, "context": { "description": "Observed project conditions used to discuss tradeoffs; context never authorises an automatic selection.", "properties": { "route": { "maxLength": 160, "type": "string" }, "placement": { "maxLength": 160, "type": "string" }, "available_width": { "enum": [ "constrained", "narrow", "wide", "adaptive" ], "type": "string" }, "item_count": { "minimum": 1, "maximum": 1000, "type": "integer" }, "content_density": { "enum": [ "low", "moderate", "high" ], "type": "string" }, "interaction_frequency": { "enum": [ "infrequent", "regular", "expert" ], "type": "string" }, "input_modes": { "maxItems": 10, "items": { "maxLength": 60, "type": "string" }, "type": "array" }, "constraints": { "maxItems": 20, "items": { "maxLength": 300, "type": "string" }, "type": "array" }, "notes": { "maxLength": 1000, "type": "string" } }, "type": "object" } }, "type": "object", "required": [ "component_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "explore_design_directions", "title": "Explore Design Directions", "description": "Generate three bounded design perspectives with structure models, style facets, fit evidence and tradeoffs. This tool never saves a selection.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "archetype_id": { "description": "Optional exact structure preset to compare across visual directions.", "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "style_id": { "description": "Optional exact named style preset to compare across structures.", "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "palette_id": { "maxLength": 160, "type": "string" }, "foundation_profile": { "properties": { "density": { "enum": [ "compact", "balanced", "relaxed" ], "type": "string" }, "type_scale": { "enum": [ "compact", "standard", "editorial" ], "type": "string" }, "icon_style": { "enum": [ "outline", "filled", "duotone" ], "type": "string" }, "breakpoint_strategy": { "enum": [ "viewport", "container", "hybrid" ], "type": "string" } }, "type": "object" } }, "type": "object", "required": [ "project_id" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "export_design_tokens", "title": "Export Design Tokens", "description": "Export bounded design tokens from a palette, style, archetype or composed design system without writing files.", "inputSchema": { "properties": { "style_id": { "type": "string" }, "archetype_id": { "type": "string" }, "palette_id": { "type": "string" }, "palette_recipe": { "properties": { "primary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "secondary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "accent_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "harmony": { "default": "auto", "enum": [ "auto", "monochrome", "analogous", "complementary", "split-complementary", "triadic" ], "type": "string" }, "expression": { "default": "balanced", "enum": [ "quiet", "balanced", "vivid", "earthy", "synthetic" ], "type": "string" }, "neutral_temperature": { "default": "neutral", "enum": [ "neutral", "warm", "cool", "seeded" ], "type": "string" } }, "type": "object", "required": [ "primary_seed" ] }, "palette_mode": { "default": "auto", "enum": [ "auto", "light", "dark" ], "type": "string" }, "foundation_profile": { "properties": { "density": { "enum": [ "compact", "balanced", "relaxed" ], "type": "string" }, "type_scale": { "enum": [ "compact", "standard", "editorial" ], "type": "string" }, "icon_style": { "enum": [ "outline", "filled", "duotone" ], "type": "string" }, "breakpoint_strategy": { "enum": [ "viewport", "container", "hybrid" ], "type": "string" } }, "type": "object" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "format": { "default": "css", "enum": [ "json", "css", "tailwind", "style-dictionary", "tokens-studio", "shadcn", "vanilla-extract", "w3c", "dtcg" ], "type": "string" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "generate_color_palette", "title": "Generate Color Palette", "description": "Generate a deterministic, stateless semantic palette from locked brand seeds without persisting or publishing the supplied colours.", "inputSchema": { "properties": { "primary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "secondary_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "accent_seed": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "harmony": { "default": "auto", "enum": [ "auto", "monochrome", "analogous", "complementary", "split-complementary", "triadic" ], "type": "string" }, "expression": { "default": "balanced", "enum": [ "quiet", "balanced", "vivid", "earthy", "synthetic" ], "type": "string" }, "neutral_temperature": { "default": "neutral", "enum": [ "neutral", "warm", "cool", "seeded" ], "type": "string" }, "contrast_target": { "default": "AA", "enum": [ "AA", "AAA" ], "type": "string" }, "lock_primary": { "default": true, "type": "boolean" }, "lock_secondary": { "type": "boolean" }, "lock_accent": { "type": "boolean" } }, "type": "object", "required": [ "primary_seed" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_catalog_status", "title": "Get Catalog Status", "description": "Return workflow capabilities plus the active catalogue version, explicit integrity state, counts, access boundary and transport status.", "inputSchema": { "properties": { "validate_schemas": { "description": "Also validate all four catalogue libraries against their packaged schemas.", "default": false, "type": "boolean" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_color_palette", "title": "Get Color Palette", "description": "Return a catalogue or generated palette recipe with OKLCH-derived light and dark semantic tokens and contrast evidence.", "inputSchema": { "properties": { "palette_id": { "pattern": "^(?:p\\d{4}-[a-z0-9]+(?:-[a-z0-9]+)*|custom-[a-z0-9]+)$", "type": "string" }, "representation": { "default": "tokens", "enum": [ "manifest", "tokens" ], "type": "string" } }, "type": "object", "required": [ "palette_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_component_contract", "title": "Get Component Contract", "description": "Get one complete framework-neutral component contract, including invariant behaviour and selectable variant axes, before implementation.", "inputSchema": { "properties": { "component_id": { "pattern": "^c\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" } }, "type": "object", "required": [ "component_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_design_project", "title": "Get Design Project", "description": "Read one private design project in a compact summary or a focused brief, direction, blueprint, tokens, reviews or full representation.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "view": { "default": "summary", "enum": [ "summary", "brief", "direction", "blueprint", "tokens", "reviews", "full" ], "type": "string" } }, "type": "object", "required": [ "project_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_design_style", "title": "Get Design Style", "description": "Return the exact reviewed manifest for one CodeCrafted Design visual style.", "inputSchema": { "properties": { "style_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" } }, "type": "object", "required": [ "style_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_website_archetype", "title": "Get Website Archetype", "description": "Return the exact reviewed manifest for one CodeCrafted Design website archetype.", "inputSchema": { "properties": { "archetype_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" } }, "type": "object", "required": [ "archetype_id" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "list_design_projects", "title": "List Design Projects", "description": "List the authenticated account’s private design projects and their current workflow state.", "inputSchema": { "properties": { "limit": { "default": 20, "minimum": 1, "maximum": 50, "type": "integer" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "plan_design_adaptation", "title": "Plan Design Adaptation", "description": "Derive deterministic device, accessibility, locale, privacy and network adaptations for one composition.", "inputSchema": { "properties": { "style_id": { "type": "string" }, "archetype_id": { "type": "string" }, "palette_id": { "type": "string" }, "palette_mode": { "default": "auto", "enum": [ "auto", "light", "dark" ], "type": "string" }, "contexts": { "minItems": 1, "maxItems": 8, "items": { "enum": [ "reduced-motion", "forced-colors", "cognitive-clarity", "low-bandwidth", "e-ink-low-refresh", "rtl-localized", "public-kiosk", "ten-foot", "wearable-glance", "spatial-computing", "privacy-sensitive", "touch-large-target" ], "type": "string" }, "uniqueItems": true, "type": "array" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "accessibility_level": { "minimum": 1, "maximum": 5, "type": "integer" }, "performance_profile": { "enum": [ "lean", "standard", "enhanced", "heavy" ], "type": "string" }, "implementation_target": { "enum": [ "framework-neutral", "nextjs", "astro", "react", "sveltekit", "plain-html", "laravel-blade", "rails", "django", "phoenix", "server-rendered", "other" ], "type": "string" }, "variant_strategy": { "default": "single-responsive-system", "enum": [ "single-responsive-system", "separate-device-shells" ], "type": "string" } }, "type": "object", "required": [ "style_id", "archetype_id", "contexts" ] }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "plan_page_content", "title": "Plan Page Content", "description": "Plan all project routes or add/update one route while preserving the approved composition, returning a route-level diff and missing-route diagnostics.", "inputSchema": { "properties": { "project_id": { "description": "Use project mode to persist a full reconciliation or one route update.", "minimum": 1, "type": "integer" }, "composition_id": { "description": "Legacy stateless mode; mutually exclusive with project_id.", "maxLength": 512, "type": "string" }, "route": { "description": "Optional single route to add or update without regenerating unrelated page plans.", "maxLength": 160, "type": "string" }, "reason": { "description": "Required with route and persisted in the project decision history.", "maxLength": 500, "type": "string" }, "add_to_required_pages": { "default": true, "type": "boolean" }, "page_patch": { "properties": { "objective": { "maxLength": 500, "type": "string" }, "primary_audiences": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "user_questions": { "maxItems": 20, "items": { "maxLength": 300, "type": "string" }, "type": "array" }, "sections": { "maxItems": 30, "items": { "type": "object" }, "type": "array" }, "primary_action": { "maxLength": 160, "type": "string" }, "success_signal": { "maxLength": 300, "type": "string" } }, "type": "object" }, "brief": { "description": "Required only for legacy stateless composition_id mode.", "properties": { "goal": { "maxLength": 500, "type": "string" }, "audiences": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "primary_actions": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "business_outcomes": { "maxItems": 20, "items": { "maxLength": 200, "type": "string" }, "type": "array" }, "required_pages": { "maxItems": 50, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "required_features": { "maxItems": 50, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "content_status": { "enum": [ "unknown", "missing", "partial", "ready" ], "type": "string" }, "brand_attributes": { "maxItems": 12, "items": { "maxLength": 80, "type": "string" }, "type": "array" }, "locked_colors": { "maxItems": 3, "items": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "type": "array" }, "accessibility_target": { "default": "AA", "enum": [ "AA", "AAA" ], "type": "string" }, "devices": { "maxItems": 12, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "implementation_target": { "default": "framework-neutral", "enum": [ "framework-neutral", "nextjs", "astro", "react", "sveltekit", "plain-html", "laravel-blade", "rails", "django", "phoenix", "server-rendered", "other" ], "type": "string" }, "decision_authority": { "description": "Who has authority to approve a persistent direction. User-led requires explicit user approval.", "default": "user_led", "enum": [ "user_led", "collaborative", "delegated" ], "type": "string" }, "experience_profile": { "default": "balanced", "enum": [ "lean", "balanced", "expressive", "immersive" ], "type": "string" }, "design_preferences": { "properties": { "novelty": { "default": "balanced", "enum": [ "familiar", "balanced", "expressive" ], "type": "string" }, "desired": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "avoid": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "references": { "maxItems": 12, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" }, "structure_preferences": { "properties": { "journeys": { "maxItems": 9, "items": { "enum": [ "discover", "compare", "transact", "learn", "create", "operate", "collaborate", "participate", "experience" ], "type": "string" }, "type": "array" }, "content_topologies": { "maxItems": 9, "items": { "enum": [ "hierarchy", "collection-detail", "graph", "feed", "dataset", "workflow-case", "conversation", "canvas", "spatial" ], "type": "string" }, "type": "array" }, "navigation_models": { "maxItems": 7, "items": { "enum": [ "hierarchical", "hub-spoke", "sequential", "faceted", "contextual", "persistent-workspace", "conversational" ], "type": "string" }, "type": "array" }, "product_zones": { "maxItems": 10, "items": { "enum": [ "public", "discovery", "learning", "service", "product", "account", "admin", "community", "commerce", "immersive" ], "type": "string" }, "type": "array" } }, "type": "object" }, "style_preferences": { "properties": { "facets": { "properties": { "layout": { "maxLength": 80, "type": "string" }, "typography": { "maxLength": 80, "type": "string" }, "color_energy": { "maxLength": 80, "type": "string" }, "material": { "maxLength": 80, "type": "string" }, "imagery": { "maxLength": 80, "type": "string" }, "motion_character": { "maxLength": 80, "type": "string" }, "tone": { "maxLength": 80, "type": "string" } }, "type": "object" }, "locked_facets": { "maxItems": 7, "items": { "enum": [ "layout", "typography", "color_energy", "material", "imagery", "motion_character", "tone" ], "type": "string" }, "type": "array" } }, "type": "object" }, "component_source": { "properties": { "type": { "default": "none", "enum": [ "none", "storybook", "shadcn", "custom" ], "type": "string" }, "reference": { "maxLength": 2048, "type": "string" } }, "type": "object" }, "constraints": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "exclusions": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "evidence": { "maxItems": 50, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object" }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "recommend_design_direction", "title": "Recommend Design Direction", "description": "Preview bounded, materially different design directions grounded in the project brief without saving a selection. Existing approved directions are preserved by default.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "archetype_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "style_id": { "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "palette_id": { "type": "string" }, "foundation_profile": { "properties": { "density": { "enum": [ "compact", "balanced", "relaxed" ], "type": "string" }, "type_scale": { "enum": [ "compact", "standard", "editorial" ], "type": "string" }, "icon_style": { "enum": [ "outline", "filled", "duotone" ], "type": "string" }, "breakpoint_strategy": { "enum": [ "viewport", "container", "hybrid" ], "type": "string" } }, "type": "object" }, "preserve_current_direction": { "description": "Retain the approved archetype, style, palette and foundations unless changed hard constraints make them ineligible.", "default": true, "type": "boolean" }, "recompute": { "description": "Project-specific stages to refresh while preserving the direction.", "maxItems": 1, "items": { "enum": [ "content_blueprint" ], "type": "string" }, "uniqueItems": true, "type": "array" } }, "type": "object", "required": [ "project_id" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "review_implementation", "title": "Review Implementation", "description": "Compare submitted implementation evidence with a project’s current design contract and save objective, likely and subjective findings plus an ordered correction plan.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "evidence": { "description": "Measured or manually verified implementation evidence. Never invent passing values.", "properties": { "source_url": { "description": "Reference only. This tool does not fetch the URL.", "maxLength": 2048, "type": "string" }, "routes": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "sections": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "components": { "maxItems": 300, "items": { "type": "string" }, "type": "array" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "accessibility_claims": { "maxItems": 100, "items": { "type": "string" }, "type": "array" }, "accessibility_violations": { "maxItems": 100, "items": { "properties": { "rule": { "type": "string" }, "impact": { "enum": [ "blocker", "high", "medium", "low" ], "type": "string" }, "message": { "type": "string" }, "remediation": { "type": "string" } }, "type": "object", "required": [ "rule", "message" ] }, "type": "array" }, "token_mismatches": { "maxItems": 100, "items": { "properties": { "token": { "type": "string" }, "message": { "type": "string" } }, "type": "object", "required": [ "token", "message" ] }, "type": "array" }, "responsive_checks": { "maxItems": 30, "items": { "properties": { "viewport": { "type": "string" }, "horizontal_overflow": { "type": "boolean" }, "hidden_required_content": { "type": "boolean" }, "layout_usable": { "type": "boolean" } }, "type": "object", "required": [ "viewport", "horizontal_overflow", "hidden_required_content", "layout_usable" ] }, "type": "array" }, "seo": { "properties": { "canonical": { "type": "boolean" }, "single_h1": { "type": "boolean" }, "server_rendered_content": { "type": "boolean" } }, "type": "object", "required": [ "canonical", "single_h1", "server_rendered_content" ] }, "performance_measurements": { "properties": { "lcp_ms": { "minimum": 0, "type": "number" }, "inp_ms": { "minimum": 0, "type": "number" }, "cls": { "minimum": 0, "type": "number" } }, "type": "object", "required": [ "lcp_ms", "inp_ms", "cls" ] }, "visual_hierarchy": { "properties": { "primary_action_clear": { "type": "boolean" }, "reading_order_matches_dom": { "type": "boolean" }, "density_consistent": { "type": "boolean" } }, "type": "object" }, "subjective_notes": { "maxItems": 50, "items": { "type": "string" }, "type": "array" } }, "type": "object", "required": [ "routes", "sections", "components", "motion_level", "accessibility_claims", "seo", "performance_measurements" ] } }, "type": "object", "required": [ "project_id", "evidence" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "search_color_palettes", "title": "Search Color Palettes", "description": "Search 1,000 deterministic, provenance-safe colour palettes by intent, industry, seed, harmony and accessibility target.", "inputSchema": { "properties": { "query": { "description": "Plain-language colour, mood or brand requirement.", "maxLength": 160, "type": "string" }, "goal": { "maxLength": 80, "type": "string" }, "industry": { "maxLength": 100, "type": "string" }, "style_category": { "maxLength": 80, "type": "string" }, "style_id": { "description": "Optional selected style whose reviewed palette preferences become defaults.", "pattern": "^\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "family": { "enum": [ "heritage", "brand-foundation", "accessibility-specialist", "data-specialist" ], "type": "string" }, "seed": { "description": "Optional brand colour used for perceptual hue ranking.", "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "harmony": { "enum": [ "monochrome", "analogous", "complementary", "split-complementary", "triadic" ], "type": "string" }, "expression": { "enum": [ "quiet", "balanced", "vivid", "earthy", "synthetic" ], "type": "string" }, "contrast_target": { "enum": [ "AA", "AAA" ], "type": "string" }, "surface_bias": { "enum": [ "light", "dark" ], "type": "string" }, "limit": { "default": 10, "minimum": 1, "maximum": 50, "type": "integer" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "search_component_contracts", "title": "Search Component Contracts", "description": "Search curated component invariants and variant capabilities, or map a public Storybook index or shadcn registry without installing code.", "inputSchema": { "properties": { "query": { "maxLength": 200, "type": "string" }, "category": { "enum": [ "action", "navigation", "input", "disclosure", "overlay", "feedback", "content", "data", "conversion", "consent" ], "type": "string" }, "variant_axis": { "description": "Return components that expose this decision axis, such as orientation or density.", "pattern": "^[a-z][a-z0-9_]*$", "type": "string" }, "variant_option": { "description": "Return components that support this option, such as vertical, compact or tray.", "pattern": "^[a-z][a-z0-9_]*$", "type": "string" }, "limit": { "default": 5, "minimum": 1, "maximum": 20, "type": "integer" }, "component_source": { "description": "Optional public component metadata source. Storybook resolves to index.json; shadcn resolves to registry.json.", "properties": { "type": { "enum": [ "storybook", "shadcn" ], "type": "string" }, "reference": { "maxLength": 2048, "format": "uri", "type": "string" } }, "type": "object", "required": [ "type", "reference" ] } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "search_design_styles", "title": "Search Design Styles", "description": "Search the 175-style catalog with hard accessibility, performance, complexity and motion constraints.", "inputSchema": { "properties": { "query": { "description": "Aesthetic, emotional or visual requirement.", "maxLength": 160, "type": "string" }, "goal": { "enum": [ "trust", "premium-conversion", "technical-credibility", "high-impact-launch", "content-depth", "product-adoption", "data-comparison", "community", "playfulness", "accessibility", "storytelling", "exploration", "commerce" ], "type": "string" }, "industry": { "maxLength": 100, "type": "string" }, "family": { "maxLength": 100, "type": "string" }, "category": { "maxLength": 80, "type": "string" }, "brand_maturity": { "enum": [ "emerging", "established" ], "type": "string" }, "content_density": { "enum": [ "low", "medium", "high" ], "type": "string" }, "performance_max": { "default": "heavy", "enum": [ "lean", "standard", "enhanced", "heavy" ], "type": "string" }, "motion_max": { "default": 3, "minimum": 0, "maximum": 3, "type": "integer" }, "complexity_max": { "default": 5, "minimum": 1, "maximum": 5, "type": "integer" }, "accessibility_min": { "default": 1, "minimum": 1, "maximum": 5, "type": "integer" }, "selection_mode": { "default": "balanced", "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "regulatory_profile": { "default": "none", "enum": [ "none", "healthcare", "finance", "government", "education", "children-family", "enterprise-saas" ], "type": "string" }, "limit": { "default": 5, "minimum": 1, "maximum": 20, "type": "integer" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "search_website_archetypes", "title": "Search Website Archetypes", "description": "Search the 100-archetype catalog for a suitable route model, component system and product structure.", "inputSchema": { "properties": { "query": { "maxLength": 160, "type": "string" }, "industry": { "maxLength": 100, "type": "string" }, "preset": { "enum": [ "P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9", "P10" ], "type": "string" }, "catalog_family": { "maxLength": 100, "type": "string" }, "risk_max": { "default": "high", "enum": [ "low", "medium", "high" ], "type": "string" }, "performance_max": { "default": "heavy", "enum": [ "lean", "standard", "heavy" ], "type": "string" }, "accessibility_min": { "default": "L", "enum": [ "L", "M", "H" ], "type": "string" }, "motion_max": { "default": 3, "minimum": 0, "maximum": 3, "type": "integer" }, "selection_mode": { "default": "balanced", "enum": [ "strict", "balanced", "exploratory" ], "type": "string" }, "regulatory_profile": { "default": "none", "enum": [ "none", "healthcare", "finance", "government", "education", "children-family", "enterprise-saas" ], "type": "string" }, "limit": { "default": 5, "minimum": 1, "maximum": 20, "type": "integer" } }, "type": "object" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "select_component_variant", "title": "Select Component Variant", "description": "Persist a route-specific component variant only after explicit user approval, retaining catalogue defaults, tradeoffs, requirements and invariant contract provenance.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "route": { "description": "Existing project route, or global/global shell scope, where this instance is used.", "minLength": 1, "maxLength": 160, "type": "string" }, "placement": { "description": "Optional bounded region such as account settings navigation.", "maxLength": 160, "type": "string" }, "component_id": { "pattern": "^c\\d{3}-[a-z0-9]+(?:-[a-z0-9]+)*$", "type": "string" }, "selections": { "description": "At least one explicitly approved axis_id to option_id choice; other axes use labelled catalogue starting points.", "type": "object" }, "approval_rationale": { "description": "Why the user chose these options and which tradeoffs they accept.", "minLength": 3, "maxLength": 1000, "type": "string" }, "user_confirmed": { "description": "Must be true for user-led projects; agents must not infer confirmation.", "type": "boolean" }, "context": { "properties": { "available_width": { "enum": [ "constrained", "narrow", "wide", "adaptive" ], "type": "string" }, "item_count": { "minimum": 1, "maximum": 1000, "type": "integer" }, "content_density": { "enum": [ "low", "moderate", "high" ], "type": "string" }, "interaction_frequency": { "enum": [ "infrequent", "regular", "expert" ], "type": "string" }, "constraints": { "maxItems": 20, "items": { "maxLength": 300, "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object", "required": [ "project_id", "route", "component_id", "selections", "approval_rationale", "user_confirmed" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "select_design_direction", "title": "Select Design Direction", "description": "Persist one previewed direction only after explicit approval, recording the rationale, authority, previous state and selected tradeoffs.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "candidate_id": { "pattern": "^direction-[a-f0-9]{20}$", "type": "string" }, "approval_rationale": { "description": "What the user prefers about this direction and which tradeoffs they accept.", "minLength": 3, "maxLength": 1000, "type": "string" }, "user_confirmed": { "description": "Must be true for user-led projects; agents must not infer confirmation.", "type": "boolean" }, "exploration": { "description": "Repeat any exact exploration constraints used to create the candidate ID.", "properties": { "archetype_id": { "type": "string" }, "style_id": { "type": "string" }, "palette_id": { "type": "string" }, "foundation_profile": { "type": "object" } }, "type": "object" } }, "type": "object", "required": [ "project_id", "candidate_id", "approval_rationale", "user_confirmed" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "undo_design_direction", "title": "Undo Design Direction", "description": "Restore the state before the latest matching direction selection or adjustment and record why it was undone.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "reason": { "minLength": 3, "maxLength": 1000, "type": "string" } }, "type": "object", "required": [ "project_id", "reason" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "update_project_brief", "title": "Update Project Brief", "description": "Merge evidenced discovery answers into a private project brief and return its completeness and next questions.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "brief_patch": { "description": "The project discovery context. Incomplete briefs are saved and returned with the next questions to ask.", "properties": { "goal": { "maxLength": 500, "type": "string" }, "audiences": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "primary_actions": { "maxItems": 20, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "business_outcomes": { "maxItems": 20, "items": { "maxLength": 200, "type": "string" }, "type": "array" }, "required_pages": { "maxItems": 50, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "required_features": { "maxItems": 50, "items": { "maxLength": 160, "type": "string" }, "type": "array" }, "content_status": { "enum": [ "unknown", "missing", "partial", "ready" ], "type": "string" }, "brand_attributes": { "maxItems": 12, "items": { "maxLength": 80, "type": "string" }, "type": "array" }, "locked_colors": { "maxItems": 3, "items": { "pattern": "^#[0-9A-Fa-f]{6}$", "type": "string" }, "type": "array" }, "accessibility_target": { "default": "AA", "enum": [ "AA", "AAA" ], "type": "string" }, "devices": { "maxItems": 12, "items": { "maxLength": 100, "type": "string" }, "type": "array" }, "implementation_target": { "default": "framework-neutral", "enum": [ "framework-neutral", "nextjs", "astro", "react", "sveltekit", "plain-html", "laravel-blade", "rails", "django", "phoenix", "server-rendered", "other" ], "type": "string" }, "decision_authority": { "description": "Who has authority to approve a persistent direction. User-led requires explicit user approval.", "default": "user_led", "enum": [ "user_led", "collaborative", "delegated" ], "type": "string" }, "experience_profile": { "default": "balanced", "enum": [ "lean", "balanced", "expressive", "immersive" ], "type": "string" }, "design_preferences": { "properties": { "novelty": { "default": "balanced", "enum": [ "familiar", "balanced", "expressive" ], "type": "string" }, "desired": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "avoid": { "maxItems": 20, "items": { "maxLength": 120, "type": "string" }, "type": "array" }, "references": { "maxItems": 12, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" }, "structure_preferences": { "properties": { "journeys": { "maxItems": 9, "items": { "enum": [ "discover", "compare", "transact", "learn", "create", "operate", "collaborate", "participate", "experience" ], "type": "string" }, "type": "array" }, "content_topologies": { "maxItems": 9, "items": { "enum": [ "hierarchy", "collection-detail", "graph", "feed", "dataset", "workflow-case", "conversation", "canvas", "spatial" ], "type": "string" }, "type": "array" }, "navigation_models": { "maxItems": 7, "items": { "enum": [ "hierarchical", "hub-spoke", "sequential", "faceted", "contextual", "persistent-workspace", "conversational" ], "type": "string" }, "type": "array" }, "product_zones": { "maxItems": 10, "items": { "enum": [ "public", "discovery", "learning", "service", "product", "account", "admin", "community", "commerce", "immersive" ], "type": "string" }, "type": "array" } }, "type": "object" }, "style_preferences": { "properties": { "facets": { "properties": { "layout": { "maxLength": 80, "type": "string" }, "typography": { "maxLength": 80, "type": "string" }, "color_energy": { "maxLength": 80, "type": "string" }, "material": { "maxLength": 80, "type": "string" }, "imagery": { "maxLength": 80, "type": "string" }, "motion_character": { "maxLength": 80, "type": "string" }, "tone": { "maxLength": 80, "type": "string" } }, "type": "object" }, "locked_facets": { "maxItems": 7, "items": { "enum": [ "layout", "typography", "color_energy", "material", "imagery", "motion_character", "tone" ], "type": "string" }, "type": "array" } }, "type": "object" }, "component_source": { "properties": { "type": { "default": "none", "enum": [ "none", "storybook", "shadcn", "custom" ], "type": "string" }, "reference": { "maxLength": 2048, "type": "string" } }, "type": "object" }, "constraints": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "exclusions": { "maxItems": 50, "items": { "maxLength": 240, "type": "string" }, "type": "array" }, "evidence": { "maxItems": 50, "items": { "maxLength": 500, "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object", "required": [ "project_id", "brief_patch" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } }, { "name": "verify_corrections", "title": "Verify Corrections", "description": "Repeat an implementation review after corrections, save the new report and identify resolved, persisting and newly introduced findings.", "inputSchema": { "properties": { "project_id": { "minimum": 1, "type": "integer" }, "previous_review_record_id": { "minimum": 1, "type": "integer" }, "evidence": { "description": "Measured or manually verified implementation evidence. Never invent passing values.", "properties": { "source_url": { "description": "Reference only. This tool does not fetch the URL.", "maxLength": 2048, "type": "string" }, "routes": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "sections": { "maxItems": 200, "items": { "type": "string" }, "type": "array" }, "components": { "maxItems": 300, "items": { "type": "string" }, "type": "array" }, "motion_level": { "minimum": 0, "maximum": 3, "type": "integer" }, "accessibility_claims": { "maxItems": 100, "items": { "type": "string" }, "type": "array" }, "accessibility_violations": { "maxItems": 100, "items": { "properties": { "rule": { "type": "string" }, "impact": { "enum": [ "blocker", "high", "medium", "low" ], "type": "string" }, "message": { "type": "string" }, "remediation": { "type": "string" } }, "type": "object", "required": [ "rule", "message" ] }, "type": "array" }, "token_mismatches": { "maxItems": 100, "items": { "properties": { "token": { "type": "string" }, "message": { "type": "string" } }, "type": "object", "required": [ "token", "message" ] }, "type": "array" }, "responsive_checks": { "maxItems": 30, "items": { "properties": { "viewport": { "type": "string" }, "horizontal_overflow": { "type": "boolean" }, "hidden_required_content": { "type": "boolean" }, "layout_usable": { "type": "boolean" } }, "type": "object", "required": [ "viewport", "horizontal_overflow", "hidden_required_content", "layout_usable" ] }, "type": "array" }, "seo": { "properties": { "canonical": { "type": "boolean" }, "single_h1": { "type": "boolean" }, "server_rendered_content": { "type": "boolean" } }, "type": "object", "required": [ "canonical", "single_h1", "server_rendered_content" ] }, "performance_measurements": { "properties": { "lcp_ms": { "minimum": 0, "type": "number" }, "inp_ms": { "minimum": 0, "type": "number" }, "cls": { "minimum": 0, "type": "number" } }, "type": "object", "required": [ "lcp_ms", "inp_ms", "cls" ] }, "visual_hierarchy": { "properties": { "primary_action_clear": { "type": "boolean" }, "reading_order_matches_dom": { "type": "boolean" }, "density_consistent": { "type": "boolean" } }, "type": "object" }, "subjective_notes": { "maxItems": 50, "items": { "type": "string" }, "type": "array" } }, "type": "object", "required": [ "routes", "sections", "components", "motion_level", "accessibility_claims", "seo", "performance_measurements" ] } }, "type": "object", "required": [ "project_id", "previous_review_record_id", "evidence" ] }, "annotations": { "destructiveHint": false, "openWorldHint": false } } ], "resources": [ { "name": "archetypes-catalog", "title": "Archetypes Resource", "description": "Stable index of all 100 reviewed CodeCrafted Design website archetypes.", "mimeType": "application/json", "uri": "design://catalog/archetypes" }, { "name": "catalog-status", "title": "Catalog Status Resource", "description": "Current catalog identity, inventory counts, transport and access boundary.", "mimeType": "application/json", "uri": "design://catalog/status" }, { "name": "component-contracts-catalog", "title": "Components Resource", "description": "Curated framework-neutral component invariants plus user-selectable layout, presentation and interaction variant axes.", "mimeType": "application/json", "uri": "design://catalog/components" }, { "name": "design-contracts", "title": "Contract Index Resource", "description": "Verified index of the schemas, policies, protocol contracts and formal release artifacts owned by design-platform.", "mimeType": "application/json", "uri": "design://contracts" }, { "name": "palettes-catalog", "title": "Palettes Resource", "description": "First page of the deterministic 1,000-palette CodeCrafted colour catalogue.", "mimeType": "application/json", "uri": "design://catalog/palettes" }, { "name": "private-design-projects", "title": "Projects Resource", "description": "Private project index for the authenticated CodeCrafted Design account.", "mimeType": "application/json", "uri": "design://projects" }, { "name": "styles-catalog", "title": "Styles Resource", "description": "Stable index of all 175 reviewed CodeCrafted Design visual styles.", "mimeType": "application/json", "uri": "design://catalog/styles" } ], "resource_templates": [ { "name": "archetype-record", "title": "Archetype Resource", "description": "Manifest or specification for one exact website archetype ID.", "mimeType": "text/plain", "uriTemplate": "design://archetype/{archetype_id}/{representation}" }, { "name": "component-contract", "title": "Component Contract Resource", "description": "One exact component invariant contract with variant axes, option tradeoffs and compatibility rules.", "mimeType": "application/json", "uriTemplate": "design://component/{component_id}" }, { "name": "design-composition", "title": "Composition Resource", "description": "Deterministic composition of an exact archetype, style and motion level.", "mimeType": "application/json", "uriTemplate": "design://composition/{archetype_id}/{style_id}/{motion_level}" }, { "name": "design-contract", "title": "Contract Resource", "description": "One exact design-platform JSON schema, policy, protocol contract or formal release artifact. Consult design://contracts for MIME type and integrity metadata.", "mimeType": "text/plain", "uriTemplate": "design://contract/{contract_id}" }, { "name": "design-policy", "title": "Policy Resource", "description": "Versioned CodeCrafted Design accessibility, quality, agent, adaptation or anti-pattern policy.", "mimeType": "application/json", "uriTemplate": "design://policy/{policy}" }, { "name": "palette-record", "title": "Palette Resource", "description": "Manifest or materialised light/dark semantic tokens for an exact catalogue or generated palette ID.", "mimeType": "application/json", "uriTemplate": "design://palette/{palette_id}/{representation}" }, { "name": "palette-swatches", "title": "Palette Swatch Resource", "description": "Accessible semantic-colour swatch strip for one exact palette ID.", "mimeType": "image/svg+xml", "uriTemplate": "design://palette/{palette_id}/swatches.svg" }, { "name": "palettes-catalog-page", "title": "Palette Catalog Page Resource", "description": "Paginated, stable summaries for the 1,000-palette catalogue; limit is capped at 100.", "mimeType": "application/json", "uriTemplate": "design://palettes/catalog/{offset}/{limit}" }, { "name": "private-design-project", "title": "Project Resource", "description": "One private project brief, composition, blueprint, decision history and review summary.", "mimeType": "application/json", "uriTemplate": "design://project/{project_id}" }, { "name": "style-record", "title": "Style Resource", "description": "Manifest or specification for one exact visual style ID.", "mimeType": "text/plain", "uriTemplate": "design://style/{style_id}/{representation}" } ], "prompts": [ { "name": "audit_design_implementation", "title": "Audit Design Implementation", "description": "Prepare an evidence-backed implementation summary for the design contract audit tool.", "arguments": [ { "name": "composition_id", "description": "The exact versioned composition ID to audit.", "required": true } ] }, { "name": "create_production_website_brief", "title": "Create Production Website Brief", "description": "Guide an agent through evidence-led discovery, saved project decisions and a production-ready frontend contract.", "arguments": [ { "name": "goal", "description": "The product or website outcome to design.", "required": true }, { "name": "audience", "description": "The primary users and decision makers.", "required": true } ] } ] }