
Tailwind Context Resolver Mcp
Loads your project's Tailwind config at runtime and exposes the resolved design system to Claude through four tools: resolve_theme_tokens to query namespaces like colors.brand or spacing, validate_class_string to catch hallucinated utilities before they ship, detect_css_conflicts to flag things like flex and grid on the same element, and get_config_summary for a high level view of customizations and plugins. Uses jiti for TypeScript config loading and tailwindcss/resolveConfig for theme resolution. Stops agents from confidently generating bg-primary-500 when your project actually uses bg-brand-primary. Works with Tailwind v3 projects only since v4 moved to CSS based config.
- tools
- 4
- transport
- STDIO
- last updated
- May 20, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
resolve_theme_tokensQuery any namespace in the resolved Tailwind theme. Returns all design tokens as flat key-value pairs.
Query any namespace in the resolved Tailwind theme. Returns all design tokens as flat key-value pairs.
No parameter schema in public metadata yet.
validate_class_stringValidates a Tailwind className string against the project's resolved config. Returns valid classes, invalid (hallucinated) classes, and conflict warnings.
Validates a Tailwind className string against the project's resolved config. Returns valid classes, invalid (hallucinated) classes, and conflict warnings.
No parameter schema in public metadata yet.
detect_css_conflictsDetects conflicting Tailwind utilities β e.g. flex + grid, or absolute + fixed on the same element.
Detects conflicting Tailwind utilities β e.g. flex + grid, or absolute + fixed on the same element.
No parameter schema in public metadata yet.
get_config_summaryReturns a compact overview: Tailwind version, prefix, which theme sections are customized, active plugins.
Returns a compact overview: Tailwind version, prefix, which theme sections are customized, active plugins.
No parameter schema in public metadata yet.
Sponsors
Readme
tailwind-context-resolver-mcp π¨πΈ
An MCP server that loads your project's tailwind.config.ts/js and exposes its actual design system to AI agents β so they stop hallucinating class names.
π€ The Problem
AI agents generate Tailwind classes based on training data β the default Tailwind docs. Your project is not the default docs.
You have a custom color palette. A non-standard spacing scale. Maybe a prefix like tw-. Brand tokens like bg-brand-primary. The agent doesn't know any of this. It guesses.
The result:
Details
- Repository
- github.com/vola-trebla/tailwind-context-resolver-mcp
- Category
- Design & Creative
- Package
tailwind-context-resolver-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from vola-trebla
- Tsconfig Inheritance Flattener Mcp
- V8 Cpu Profile Decoder Mcp
- Release Readiness Triage Mcp
- React Render Profile Mcp2
- Playwright Trace Decoder Mcp1
- Ast Impact Mapper Mcp
- Env Secret Exposure Analyzer Mcp
- Flakiness Knowledge Graph Mcp
- Ndjson Local Log Triage Mcp
- Playwright Network Chaos Mcp
- Playwright Spatial Layout Mcp
- Sourcemap Retrace Mcp