Skip to content
MCP server

Refy

MCP server that finds Refy React components by need and checks code against their API

Status and history

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/mcp

Add to Settings → Connectors → Add custom connector

https://refy.design/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "refy": {
      "url": "https://refy.design/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory