MCP server

The UIX MCP server lets an AI agent make a design system, read the ones in your account and fetch components in your colors.

The server

The server works over HTTP. Most agents only need its address and, for your own design systems, an API key.

Server URL

https://useuix.com/mcp

Preset tools work without a key. Anything that saves to or reads from your account needs one.

Set it up

Create an API key
Sign in at /account and create a key under API key. Keys are free. Copy it right away: you won’t see it again. Treat it like a password.
Add the server to Claude Code
Run this in your project folder, with your key in place of <your key>.
Terminal
```
claude mcp add --transport http uix https://useuix.com/mcp --header "Authorization: Bearer <your key>"
```

Or add it to Cursor

Put this in .cursor/mcp.json in your project.

.cursor/mcp.json

{
  "mcpServers": {
    "uix": {
      "url": "https://useuix.com/mcp",
      "headers": { "Authorization": "Bearer <your key>" }
    }
  }
}

Ask for what you need
For example: “Make a design system for a calm telehealth app, teal, and use it on the settings page.” The agent picks the tools below on its own.

Other agents use the same address and the same Authorization: Bearer <your key> header. Your account page shows ready-to-copy setups for Claude Code, Cursor and a plain JSON config.

Tools

Tool	What it does	Key
`create_design_system`	Makes a full design system from a short brief: color scales, light and dark themes, fonts, radius, spacing and shadcn-ready tokens, with a contrast receipt. With a key it is saved to your account.	Optional
`list_my_design_systems`	The systems in your account: id, name, version, last change and Studio link.	Yes
`get_design_system`	One saved system. By default a summary (colors per theme, fonts, radius, install links, contrast receipt) plus its CSS variables.	Yes, the owner’s
`get_component`	React code for one component in that system’s tokens, plus `lib/utils.ts`.	Yes, the owner’s
`search_presets`	Finds presets by keyword, mood or industry.	No
`get_preset`	One file of a preset, such as its DESIGN.md or theme CSS.	Pro presets only

create_design_system

Argument	Meaning
`brief`	Required. What the app is and how it should feel, up to 2,000 characters. For example “a calm telehealth app for busy parents, teal”.
`primary`	The main brand color, as a hex like `#0F766E` or a word like “teal”. Left out, it comes from the brief.
`style`	One of `modern`, `minimal`, `corporate`, `friendly`, `playful`, `bold`, `calm`, `editorial`, `luxury`, `tech`. It sets fonts, corners and the color scheme. Left out, it comes from the brief, or `modern`.
`name`	A name for the system, up to 80 characters.

With a key, the answer has the new id, a Studio link and install commands: the CSS link, npx shadcn add and npx uix-ui pull. Without a key nothing is saved, and the agent gets the CSS variables to paste. A free account keeps one system; if it already has one, the tool says so and points to it.

get_design_system

Takes id and an optional file:

file	Returns
`summary`	The default: a tokens summary and the CSS variables.
`css`	CSS variables for light and dark.
`tailwind`	The Tailwind v4 theme.
`agents-md`	AGENTS.md, the UI rules for agents. See AI Pack.
`design-md`	DESIGN.md, the full spec.

get_component

Takes id, name (like button, icon-button or date picker) and an optional framework, which is react for now. The code is shadcn-style React with TypeScript, Tailwind and class-variance-authority. It needs your theme CSS, from get_design_system or your CSS link. Free accounts get the 12 core components; UIX Pro gets all of them.

search_presets and get_preset

search_presets takes an optional query, tier (free, pro or all), mood, industry and limit (1 to 50, 20 by default). get_preset takes an id and a format: design-md, theme-css, tokens, shadcn, figma-variables or preset-json. Free presets need no key. Pro presets need a key from an account with UIX Pro.

A typical session

What happens

agent

mcp · useuix.com

call list_my_design_systems
call get_design_system
call get_component

200 OK

You ask for a settings page in your app’s style.
The agent calls list_my_design_systems and finds your system’s id.
It calls get_design_system with file: "agents-md" to read your rules, then get_component for the Switch and the Card.
It builds the page with your tokens and links your CSS, without making up new colors.

Troubleshooting

“This needs a UIX API key.” The server got no key. Check the Authorization header in your agent’s config.
“This UIX API key is not valid.” The key was revoked or mistyped. Create a new one at /account.
“No design system with the id … in this account.” The id belongs to another account, or has a typo. Ask the agent to run list_my_design_systems.
The agent doesn’t list the tools. The server only answers POST requests and has no event stream. Use the HTTP transport in your agent’s settings.