app.refcatPublished by refcat.appOfficial publisherv1.0.0Updated Nov 1, 2026
Search 1M real UI flows and 3.3M screens from shipped apps, sites, emails and games.
Refcat lets an assistant search a catalog of real app, web and email screens and flows to use as UI references before designing.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/app.refcat%2Frefcat/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"refcat": {
"type": "http",
"url": "https://mcp.refcat.app/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}List filter values
The filter vocabulary with real counts (number of flows): platform, flowIntents, uiComponents, pageType and screenPatterns. Call this before filtering search_screens or search_flows so filters are real values, not guesses. Optional query/filters narrow every count, flowIntents included.
queryfiltersGet screen
One catalog screen with its image and structure. Returns an image block (look at it for color, typography and spacing) and JSON with app, flow, platform, pageType, screenPatterns, uiComponents, keyTexts, dimensions, capturedAt and `elements` (OCR text and hotspots with normalized bbox [x0,y0,x1,y1], sorted top to bottom: use them to reproduce hierarchy, order and positions). image 'small' is ~800px wide (~1-2k tokens), 'full' 1800px. Cite the app, flow and capture date when you build from it.
imagescreenDocIdrequiredincludeElementsSearch screens by image
Find catalog screens that look like your images (base64, e.g. a screenshot of the app you are building). Then call get_screen on the matches to compare. Free plans: up to 2 images and 12 results.
limitimagesrequiredSearch screens
Search individual UI screens by description, app name or site ('paywall with annual plan first', 'Spotify', 'linear.app'). Returns metadata per screen; set includeImages to also get the top screens as images (max 4, ~1-2k tokens each). Call get_screen for the full structure of one.
limitqueryrequiredoffsetfiltersincludeImagesSearch flows
Search whole flows (ordered screen sequences) by intent, app or description. Then get_flow for the steps.
limitqueryoffsetplatformflowIntentsSearch emails
Search real product emails (welcome, receipts, onboarding, re-engagement…) by description or brand. Each result is one email with its desktop and/or mobile image; when hasHtml is true, get_email_html returns the original HTML to adapt. Needs Pro.
appIdlimitqueryoffsetflowIntentsGet email HTML
The original HTML of one email from search_emails (tables, font fallbacks, dark mode included). Adapt it to the user's brand instead of writing email HTML from scratch. Pro, or this week's free flows.
emailIdrequiredSearch apps
Find apps in the catalog by name, website or theme ('nubank', 'linear.app', 'meditation').
limitqueryrequiredplatformGet app
Metadata for one app in the catalog. Accepts an appId or a slug like 'spotify'. get_app_flows lists its flows.
appIdrequiredGet app flows
The flows of one app (onboarding, checkout, settings…) in order, with capture date. Accepts an appId or slug. Big apps have hundreds of flows: page with offset. Then get_flow for the steps of one.
appIdrequiredlimitoffsetFind similar apps
Apps like this one, ranked from the app's own flow themes. Accepts an appId or slug.
appIdrequiredGet flow
One flow with every step in order. Compact by default: each step has screenDocId (for get_screen), pageType, patterns, components and keyTexts. include 'elements' adds OCR/hotspot boxes per step (large: tens of thousands of tokens for a long flow); 'connections' adds step links.
flowIdrequiredincludeGet flow history
Earlier captures of the same flow (how it changed over time): capture date, screen count and up to 3 preview images each.
flowIdrequiredFind similar screens
Screens that look like a given screen. Visual, not keyword — no quota. includeImages returns the top matches as images (max 4).
limitscreenDocIdrequiredincludeImagesList categories
The catalog's category rail for a platform, with the key list_apps filters by. Emails, games, store listings and ads have their own rails.
platformList apps
Apps in the catalog, optionally filtered by category key (from list_categories) or platform. Platform `email` lists brands with email galleries.
limitoffsetcategoryplatformList projects
The caller's projects, newest first.
Takes no parameters.
Get project
One project with its screens, positions and connections.
projectIdrequired83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.