Developers and AI agents

Design references,
ready for your AI.

Use one read-only connection to search products, inspect flows, and retrieve protected reference images. A verified UIAIdol login and active Pro plan are required.

CLI quickstart

Search from any terminal.

The login command opens UIAIdol in your browser, verifies your Pro plan, then stores a time-limited developer token locally. Node.js 20.9 or later is supported. Developer access has no free tier and includes up to 100 preview deliveries and 25 MiB of reserved image data per UTC day across the API, CLI, and MCP. Reference search allows up to 60 calls per minute, while image and IP protections remain independently enforced.

npx -y https://assets.uiaidol.com/uiaidol/v1/releases/uiaidol-cli-0.4.0.tgz login
npx -y https://assets.uiaidol.com/uiaidol/v1/releases/uiaidol-cli-0.4.0.tgz screens "pricing" --platform web
npx -y https://assets.uiaidol.com/uiaidol/v1/releases/uiaidol-cli-0.4.0.tgz connect

Remote MCP

Modern AI clients

Paste the endpoint into ChatGPT, Claude, Codex, or another modern MCP client. Standards-based OAuth opens UIAIdol in your browser and supports PKCE, refresh rotation, and automatic client registration. The CLI token remains available for older clients.

https://mcp.uiaidol.com/mcp

Local stdio MCP

Claude, Cursor, Codex, and more

Use the CLI as a local MCP process when a client expects stdio.

{
  "mcpServers": {
    "uiaidol": {
      "command": "npx",
      "args": [
        "-y",
        "https://assets.uiaidol.com/uiaidol/v1/releases/uiaidol-cli-0.4.0.tgz",
        "mcp"
      ]
    }
  }
}

AI-native tools

Dedicated search and visual evidence.

search_screens

Search individual iOS and web screens with local hybrid ranking and up to four model-visible pixels per call.

search_flows

Search complete journeys, preserve exact screen order, and page through the strongest flow four images at a time.

search_sections

Search reusable website sections with local synonym expansion and protected image delivery.

find_design_references

Find relevant products and return a bounded set of watermark-free previews as model-visible MCP images and short-lived URLs.

search_products

Search product names, flows, actions, categories, markets, and platforms.

get_product

Return one stable product profile with verified website or app-store destinations, flow metadata, and attribution.

list_product_assets

Page through every product image, up to four at a time, with model-visible MCP content and short-lived URLs.

HTTP API

Plain JSON when MCP is unnecessary.

The same catalog is available through read-only API endpoints with an OAuth access token or the bearer token created by uiaidol login. Set preview_limit=0 for a metadata-only search that consumes no image allowance; request one to four previews only when pixels are needed.

curl -H "Authorization: Bearer $UIAIDOL_ACCESS_TOKEN" \
  "https://mcp.uiaidol.com/api/v1/screens/search?q=pricing&platform=web&preview_limit=0"

Human-friendly research

Use the same evidence in the visual product library.

Browse products

Design references,ready for your AI.