For developers and AI agents

Put the library inside your editor.

Search real design references through JSON or MCP. Connect your account to use its search allowance; design briefs and image plans require Pro.

MCP server

Use this hosted URL in ChatGPT, Claude, Cursor, Claude Code, Codex or VS Code. Complete account sign-in and enable UI Discovery in your conversation. See Connect for setup, output-specific prompts and a live console.

Connector URL

https://uidiscovery.com/mcp

Claude Code

claude mcp add --transport http uidiscovery https://uidiscovery.com/mcp

Once connected, your agent gets a short guide to the library and these tools. Search results include preview images the model can actually look at, plus a link for every reference:

search_sectionsWebsite sections — hero, pricing, features, testimonials, FAQ, footer… Describe one section in plain language.

search_screensApp screens (platform ios) or web-app / dashboard UI (platform web).

search_flowsMulti-step journeys recorded from real products, with every step in order.

search_sitesWhole products by name, industry or style, with their section ids.

search_graphicsGraphics references for posters, social posts, greetings and campaigns, with inspectable previews.

get_referenceReopen an exact section/screen or product with previews and catalog dates; no Pro brief needed.

compare_referencesInspect 2–4 selected references together: actual images, typography, palette and dimensions.

prepare_design_handoffSelected section/screen captures plus your brand, copy, dimensions and required states for a specific output. Prepares a package; does not create or save a design.

find_similarVisually related alternatives using pixel layout, texture and colour; scores do not measure design quality.

get_design_briefPro: the full build brief (structure, tokens, font swaps, steps and checklist) for a product slug or section/screen id, with a preview image.

get_image_planPro: the reference's image style, source searches and an image-generation prompt for each image slot.

get_design_tokensColour roles, palette and font stacks as JSON, ready for CSS variables or Tailwind.

The server tells your agent the workflow: search → inspect reference previews → create the requested original artifact → verify and cite. Build briefs and image plans are optional enrichment. There's also a design_with_references prompt: give it a brief and the agent researches references first, then designs something original.

UI Discovery returns references and guidance. Your assistant needs image-generation, Figma or coding tools to create the requested output. If you request editable Figma, the final file must contain editable text and any actual image assets.

REST API

Create an API key in account settings and store it as UIDISCOVERY_API_KEY. Set UIDISCOVERY_URL to https://uidiscovery.com. Send the key in the Authorization header. Account and allowance errors return 401, 402 or 429; check the message before retrying.

Catalog lists return at most 25 records per request. Use offset and the response's nextOffset to load another page. List reads allow 120 requests per minute per connection; a 429 response includes Retry-After. Capture dates and age in days are reported where available, and older captures remain visible.

GET /api/v1/sections

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/sections?type=pricing&style=Dark&limit=3"

idOne section by id

qMatch site name, headings or copy

typehero, features, showcase, logos, testimonials, stats, pricing, how-it-works, integrations, faq, cta, blog, team, about, statement, content, footer, screen

categoryAI, Technology, Finance, Shopping, Lifestyle, Portfolio

styleLight, Dark, Minimal, Colorful, Serif, Mono

limit / offsetPaging, up to 25 per request

Each result includes the screenshot URL, palette, fonts and headings. Pro responses also include build prompts.

GET /api/v1/sites

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/sites?category=Finance&color=blue"

GET /api/v1/prompts

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/prompts"

Prompt results are original UIDiscovery build briefs with intent, tags and links back to the relevant reference patterns.

GET /api/v1/search

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/search?q=fintech+onboarding"

Search combines sites, sections and prompts. Explicit platform words (ios, website) and domains (fintech, education) boost matching references before ranking. When TYPESAFE_API_KEY is configured, JEV re-ranks the top of the fast shortlist by product-design relevance (results carry rankedBy and a cached flag); append ai=0 for deterministic fast ranking.

GET /api/v1/brief — build brief for one reference

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/brief?slug=linear"                  # whole page, Markdown
curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/brief?section=linear-1"              # one section or screen
curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/brief?slug=linear&format=json"       # structure, tokens, image plan + markdown
curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/brief?slug=linear&part=images"       # imagery plan only

slugSite / app slug — a whole-page brief

sectionSection or screen id (alias: id) — a single-section brief; slug is optional

formatmd (default, text/markdown) or json

partimages — only the imagery plan (stock searches + AI generation prompts per slot)

The same brief powers the Build with AI button on every site and section page, the kit's PROMPT.md and the MCP server. It asks for an original build: new copy, your brand, free font stand-ins for licensed faces, and images from royalty-free stock or generation prompts — never the reference's own assets.

GET /api/v1/brief — map a product brief to references

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/brief?brief=calm+mobile+onboarding+for+a+finance+app"

Brief mapping uses JEV to choose a product journey and platform, then returns a ranked set of relevant sites, sections, and original build prompts.

GET /api/v1/flows

curl -H "Authorization: Bearer $UIDISCOVERY_API_KEY" "$UIDISCOVERY_URL/api/v1/flows?track=onboarding"

Flow kits return an original three-step build sequence with the matching reference queries and prompt ids.