Getting Started

Give your AI agent design taste

Refero MCP connects your agent to a searchable catalog of websites and iOS apps, curated design styles, real product screens, and user flows. It studies before it builds, so output is grounded in shipped product patterns instead of generic model taste. Models are strong at code and logic, but product design needs references: visual systems, interface patterns, flow sequencing, and the details that make a UI feel intentional. Refero gives agents that research layer.

What you need

A paid Refero plan — Pro, Team, or Lifetime is required. See plans.
A supported AI tool — ChatGPT, Codex, Claude Code, Cursor, Antigravity, Lovable, Manus, or another tool that supports remote MCP servers.

Connect your tool

ChatGPT / Codex plugin

Open Refero in the OpenAI Plugins Directory and install the plugin.
Connect Refero and sign in with your Refero account when prompted.
Start a new chat and try one of the searches below.

The plugin includes Refero MCP and Refero Skill. You do not need to add an MCP config or install the skill separately.

Manual MCP setup

Use this alternative for Codex or to connect another MCP-compatible tool. Use this MCP server URL:

https://api.refero.design/mcp

Depending on your tool and account setup, authorization may happen through OAuth or through a Bearer token from Refero.

Claude Code
Cursor
Codex
Other

claude mcp add --transport http refero https://api.refero.design/mcp --header "Authorization: Bearer <token>"

If your setup uses OAuth instead of an API token, omit the --header part and follow the sign-in flow your MCP client opens.

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "refero": {
      "url": "https://api.refero.design/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

If Cursor offers OAuth for the connector, you can use that instead of a static token.

Add to your Codex MCP config:

[mcp_servers.refero]
enabled = true
url = "https://api.refero.design/mcp"

[mcp_servers.refero.http_headers]
Authorization = "Bearer <token>"

Field	Value
Server name	`Refero`
Server URL	`https://api.refero.design/mcp`
Authentication	OAuth or `Authorization: Bearer <token>`

Refer to your tool’s MCP documentation for where to add remote server credentials.

Refero MCP works best with Refero Skill. If the skill is missing, your agent may offer to run npx skills add https://github.com/referodesign/refero_skill --skill refero-design. Refero MCP tells the agent to ask for your approval before running the command. If you decline, Refero MCP continues to work normally.

Try a search

Ask your agent:

Search Refero sites for fintech products with strong dashboard design

or:

Search Refero apps for minimalist productivity tools

or:

Search Refero styles for developer tool websites with product screenshots

or:

Search Refero screens for pricing page annual monthly toggle on web

or:

Search Refero flows for subscription cancellation with retention offer on web

How it works

Refero starts with product discovery and adds three research layers:

Sites and apps for finding web and iOS products by company, domain, industry, category, topic, or visual direction.
Styles for visual direction: typography, color, layout, spacing, surfaces, components, imagery, and do/don’t rules.
Screens for concrete UI patterns: page structure, content hierarchy, copy, states, and components.
Flows for journey logic: step count, decisions, friction, recovery paths, and system responses.

Your agent -> MCP over HTTP -> Refero API -> sites, apps, styles, screens, and flows

All data stays server-side. Only the results your agent requested come back.

Limits

Standard MCP access with Pro, Team, or Lifetime includes up to 8,000 MCP tool calls per monthly usage period for each licensed user. This is intended for routine design research and protects the service from automated abuse. Most users will not need to monitor it. Unused calls do not roll over. Need more? See Integrate Refero for higher limits, custom integrations, and usage-based pricing. For questions, write to mike@refero.design.

Tools

Current tools for sites, apps, styles, screens, images, similar screens, and flows.

Examples

Simple workflows for combining the research layers.

Refero Skill

Install a research-first design methodology into your agent.

MCP Server

Refero Skill

Figma Plugin

Help

Legal

Getting Started

Give your AI agent design taste

What you need

Connect your tool

ChatGPT / Codex plugin

Manual MCP setup

Try a search

How it works

Limits

Next

Tools

Examples

Refero Skill

​Give your AI agent design taste

​What you need

​Connect your tool

​ChatGPT / Codex plugin

​Manual MCP setup

​Try a search

​How it works

​Limits

​Next

Tools

Examples

Refero Skill

Give your AI agent design taste

What you need

Connect your tool

ChatGPT / Codex plugin

Manual MCP setup

Try a search

How it works

Limits

Next