Refy — Claude Code MCP server: what it does, how to install
Refy — an MCP server for Claude Code that lets the agent search design system components, inspect APIs, and validate code against the real library.
MIT ★ 13 updated 2026-11-15
claude mcp add --transport http refy https://refy.design/mcpWhat Refy does
Refy connects the AI agent to a React and TypeScript component library. The server provides eight tools to search components by description, inspect APIs, validate code, and generate themes with AA contrast. Running the tools requires Node.
The package handles multilingual component queries, checks code against rules, and compares visual layouts. A remote server at https://refy.design/mcp supports the first seven tools without reading local files.
What it helps with
- find a UI component by natural language description
- validate screen code against the real component API
- generate and check themes with AA contrast
- compare original screenshots with implemented screens
Example prompts for the agent
- Find a data table component in refy
- Check
src/Screen.tsxagainst refy API rules - Generate a new theme using refy
How to install Refy
Platform CLI: remote server
claude mcp add --transport http refy https://refy.design/mcpPlatform CLI: remote server
codex mcp add refy --url https://refy.design/mcpConfig file
{
"mcpServers": {
"refy": {
"url": "https://refy.design/mcp"
}
}
}Config file
{
"servers": {
"refy": {
"type": "http",
"url": "https://refy.design/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http refy https://refy.design/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Refy
How to install Refy in Claude Code?
Run claude mcp add --transport http refy https://refy.design/mcp in your terminal.
What does Refy do?
It gives your AI agent direct access to a design system catalog, component search, API inspection, and theme validation inside the chat.
What is required to run Refy?
Node is required for local code analysis.