# Refy

> Refy is an open-source MCP server for developer tools. MCP server that finds Refy React components by need and checks code against their API. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://refy.design/para-ias/plugin
- **Repository:** https://github.com/viniciuscoimbra/refy-design
- **MCP Registry name:** design.refy/refy
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http refy https://refy.design/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://refy.design/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "refy": {
      "url": "https://refy.design/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "refy": {
      "type": "http",
      "url": "https://refy.design/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "refy": {
      "serverUrl": "https://refy.design/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "refy": {
      "type": "http",
      "url": "https://refy.design/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/refy
