app.refcat/refcat · v1.0.0 · communication
Refcat is healthy: it completed an MCP handshake in 3707 ms and exposes 18 tools.
Search 1M real UI flows and 3.3M screens from shipped apps, sites, emails and games.
Endpoint: https://mcp.refcat.app/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 18 |
| Latency | 3707 ms |
| Last checked (UTC) | 2026-11-01T19:45:25.748Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-01T19:45:25.748Z | Healthy | 3707 |
list_facets | 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. |
get_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], |
search_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. |
search_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. |
search_flows | Search whole flows (ordered screen sequences) by intent, app or description. Then get_flow for the steps. |
search_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. |
get_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. |
search_apps | Find apps in the catalog by name, website or theme ('nubank', 'linear.app', 'meditation'). |
get_app | Metadata for one app in the catalog. Accepts an appId or a slug like 'spotify'. get_app_flows lists its flows. |
get_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. |
similar_apps | Apps like this one, ranked from the app's own flow themes. Accepts an appId or slug. |
get_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. |
get_flow_history | Earlier captures of the same flow (how it changed over time): capture date, screen count and up to 3 preview images each. |
similar_screens | Screens that look like a given screen. Visual, not keyword — no quota. includeImages returns the top matches as images (max 4). |
list_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. |
list_apps | Apps in the catalog, optionally filtered by category key (from list_categories) or platform. Platform `email` lists brands with email galleries. |
list_projects | The caller's projects, newest first. |
get_project | One project with its screens, positions and connections. |