vola-trebla avatar

Tailwind Context Resolver Mcp

vola-trebla/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 tools

Public 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 🎨🐸

npm version npm downloads CI License: MIT

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:


View the full README on GitHub

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

Related Design & Creative MCP servers

View all
1miapre avatarHTML to Figma β€” Design Systemmiapre/html-to-figma-design-systemTranslate HTML prototypes into Figma using your design system's real components and tokens.3stars
2vrun-design avatarOpenflowkit Mcpvrun-design/openflowkitArchitecture diagrams for your agent: draw on the live OpenFlowKit canvas or edit diagram files.931stars
3ivanmurzak avatarAI Game Developer: MCP for Unity, Unreal and Godotivanmurzak/unity-mcpMake games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.4.6Kstars
4yctimlin avatarExcalidrawyctimlin/mcp_excalidrawProvides an Excalidraw canvas exposed via MCP for real-time diagramming and element CRUD from AI agents.1.9Kstars
5figma avatarFigma MCP Serverfigma/mcp-server-guideThe Figma MCP server brings Figma design context directly into your AI workflow.0stars
6tranhoaihung avatarFigma Ui Mcptranhoaihung/figma-ui-mcpBidirectional Figma MCP β€” AI draws UI on Figma canvas, reads designs back266stars