Refy
MCP server that finds Refy React components by need and checks code against their API
Answered our latest tool-list check 21 hours ago with 7 tools. It will be marked verified after 3 successful checks in 7 days.
- Pricing
- Open source
- Platforms
- API, CLI
- Runs
- Remotely
- Version
- 1.6.1
- Listing updated
- 3 days ago
About Refy
Refy is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
Refy is a React and TypeScript component library under the MIT licence, with a catalogue of 122 component families, and this server lets an agent use the catalogue while writing screens. refy_search accepts a need in Portuguese, English or Spanish, refy_component reads a component's API, refy_collections lists the capability collections, and refy_validate checks code against the documented API.
A theme tool, refy_theme_extract, reads a public site URL and produces light and dark themes with AA contrast and the reason for each choice, without copying the page. It is the only tool that touches the network, and only for the address you give. The server reads the bundled catalogue and tokens, writes nothing to your project and calls no AI model.
Install it as a Claude or Codex plugin, as a Claude Desktop .mcpb file, or use the remote endpoint without account or key. A local variant runs through npx with Node 20 or later. The site is in Portuguese.
Install
Run in a terminal
claude mcp add --transport http refy https://refy.design/mcpAdd to Settings → Connectors → Add custom connector
https://refy.design/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"refy": {
"url": "https://refy.design/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"refy": {
"type": "http",
"url": "https://refy.design/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"refy": {
"serverUrl": "https://refy.design/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"refy": {
"type": "http",
"url": "https://refy.design/mcp"
}
}
}Tools this server provides (7)
Read directly from the server.
- refy_search
- Encontra a família do Refy para uma necessidade descrita em português, inglês ou espanhol ("confirmar antes de apagar", "lista suspensa com busca"). Devolve as famílias em ordem, com o motivo, como usar, quando usar outra e o import.
- refy_component
- Devolve a API real (props, tipos, obrigatórias), exemplos de código, uso, alternativas e teclado de uma família ou de um membro documentado (ex.: Button, CardHeader, D3Chart).
- refy_collections
- Lista as coleções do catálogo (core e especializadas) com os membros reais de cada uma.
- refy_validate
- Confere código de tela contra o contrato do Refy: props obrigatórias, valores fora da união aceita, props fora da API, controles HTML crus, cor/fonte literal e import interno. Recebe o código da tela em code.
- refy_theme_generate
- Gera um tema completo (claro e escuro) a partir da cor primária, com raio, densidade e fontes opcionais. O tema sai no formato do ThemeProvider e já conferido: tokens reconhecidos, referências e contraste AA.
- refy_theme_extract
- Lê cores, fontes e raios de um site e monta um tema do Refy (claro e escuro) já conferido em contraste AA, com a razão de cada escolha. Recebe url (lê o HTML e o CSS servidos), html/css, ou observations da sonda refy://theme-probe rodada no navegador do agente, que é a leitura mais fiel para site montado por JavaScript.
- refy_theme_validate
- Confere um tema (objeto do ThemeProvider) contra o contrato dos temas do Refy: tokens reconhecidos, label, referências resolvíveis e contraste AA de texto, estado e marca, no claro e no escuro.
What it does
- Search by need
- Finds a component family from a written need in three languages.
- API lookup
- Reads a component's documented API.
- Code validation
- Checks screens against the real API.
- Theme extraction
- Builds light and dark AA-contrast themes from a site.
- Plugin shortcuts
- Claude and Codex plugins add screen and theme skills.
Good for
- Pick the right data table component
- Verify generated screen code uses real props
- Derive a theme from a brand site
- Build screens from documented composition
Pricing
Open source
MIT licence; remote server needs no account
Prices change. Check refy.design before you buy.
Refy FAQ
Does it need an account?
No. The remote server works without an account or key.
Does it change my project?
No. The server only reads its catalogue and does not write to your project.
Is Refy open source?
The library is MIT licensed.
Which clients are covered?
Claude Code, the Claude app, Claude Desktop and Codex.
Is Refy free?
Yes. Refy is open source, so you can use and self-host it for free.
How do I add Refy to Claude Code?
Run this command in your terminal: claude mcp add --transport http refy https://refy.design/mcp
What are the best alternatives to Refy?
The closest alternatives to Refy are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Refy

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory