MCP API Reference

13 tools available via the MCP protocol. Endpoint: https://ds.visionvolve.com/mcp/mcp. Most tools accept an optional brand parameter ("visionvolve" | "aitransformers") to return brand-specific tokens.

Token Tools (7)

ds_get_colors

Get design system colors grouped by category.

category? "brand" | "neutral" | "semantic" | "domain"
brand? "visionvolve" (default) | "aitransformers"
Example response
{
  "brand": {
    "visionPurple": {
      "hex": "#6E2C8B",
      "description": "Primary brand purple",
      "usage": "Primary buttons, headings"
    }
  }
}
Example response
{
  "brand": {
    "primary": {
      "hex": "#00BDD6",
      "description": "Primary cyan — main brand color",
      "usage": "Primary buttons, links, accents"
    }
  }
}

ds_get_color

Get a single color by name.

name e.g. "visionPurple", "evolveCyan"
brand? "visionvolve" (default) | "aitransformers"

ds_get_typography

Get font families, weights, and size scale.

brand? "visionvolve" (default) | "aitransformers"

ds_get_spacing

Get spacing scale with mm, px, and rem.

brand? "visionvolve" (default) | "aitransformers"

ds_get_borders

Get border radius tokens.

brand? "visionvolve" (default) | "aitransformers"

ds_get_gradients

Get pre-defined gradients with CSS values.

brand? "visionvolve" (default) | "aitransformers"

ds_search_tokens

Fuzzy search across all token types.

query e.g. "purple", "heading", "#6E"
brand? "visionvolve" (default) | "aitransformers"

Component Tools (2)

ds_list_components

List components with summaries.

category? "layout" | "card" | "data" | "indicator"
brand? "visionvolve" (default) | "aitransformers"

ds_get_component

Get full component spec with HTML, CSS, tokens.

component_id e.g. "cover", "info-card", "nice-table"
brand? "visionvolve" (default) | "aitransformers"

Brand Tools (2)

ds_get_brand

Get brand info: name, tagline, palette, guidelines.

brand? "visionvolve" (default) | "aitransformers"

ds_get_logo_info

Get logo variants with download URLs and usage rules.

brand? "visionvolve" (default) | "aitransformers"

Validation Tools (2)

ds_validate_color

Check if a color matches the design system. Returns nearest match + WCAG contrast.

hex_color e.g. "#6E2C8B" or "6E2C8B"
brand? "visionvolve" (default) | "aitransformers"
Example response
{
  "match": "exact",
  "name": "visionPurple",
  "hex": "#6E2C8B",
  "contrast_vs_white": {
    "ratio": 7.42,
    "AA_normal": true,
    "AAA_normal": true
  }
}
Example response
{
  "match": "exact",
  "name": "primary",
  "hex": "#00BDD6",
  "contrast_vs_white": {
    "ratio": 3.12,
    "AA_normal": false,
    "AAA_normal": false
  }
}

ds_get_css_variables

Get complete :root CSS custom properties block.

brand? "visionvolve" (default) | "aitransformers"