Skip to content

Set up the MCP server

Connect Claude Code, Cursor or Claude Desktop to SuperDuper with a personal key. It takes about two minutes.

Endpoint (Streamable HTTP)

POST https://www.superduperui.com/api/mcp
Authorization: Bearer sdui_YOUR_KEY

Get a key

  1. 1. Open your account page

    Sign in and go to your account. Any account can create a key, free or Pro.

  2. 2. Create a key

    Under API & MCP access, create a key and copy it. You only see it once. It starts with sdui_.

  3. 3. Paste it into a config

    Paste it into one of the configs below in place of sdui_YOUR_KEY. You can hold 2 live keys and create 3 a day, so you can swap in a new key before you revoke the old one.

Add it to your client

Every request sends the key in the Authorization header. Replace sdui_YOUR_KEY with your own.

  • Claude Code

    Run this in your terminal.

    Claude Code

    claude mcp add --transport http superduperui https://www.superduperui.com/api/mcp \
      --header "Authorization: Bearer sdui_YOUR_KEY"
  • Cursor

    Add this to ~/.cursor/mcp.json, or .cursor/mcp.json in a project.

    Cursor

    {
      "mcpServers": {
        "superduperui": {
          "url": "https://www.superduperui.com/api/mcp",
          "headers": {
            "Authorization": "Bearer sdui_YOUR_KEY"
          }
        }
      }
    }
  • Claude Desktop

    Add this to claude_desktop_config.json (Settings, Developer, Edit config), then restart Claude.

    Claude Desktop reaches servers that use a key through the mcp-remote bridge, which needs Node.js.

    Claude Desktop

    {
      "mcpServers": {
        "superduperui": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://www.superduperui.com/api/mcp",
            "--header",
            "Authorization:${SDUI_AUTH}"
          ],
          "env": {
            "SDUI_AUTH": "Bearer sdui_YOUR_KEY"
          }
        }
      }
    }

Other clients: anything that speaks MCP over Streamable HTTP and lets you set a header works. Send Authorization: Bearer sdui_… with every request. Sign-in without a key, for connectors such as Claude.ai, is on the way.

Check it works

Ask your agent about a flow or a screen. It picks the right tool on its own.

  • “Find three onboarding flows from finance apps and tell me when each one asks for notification permission.”

  • “Show me paywall screens with a free-trial toggle, then get the full text of the best one.”

  • “How do music apps handle cancelling a subscription? List the steps and transitions.”

  • “I’m building a filters bottom sheet in React Native. Find real examples and the elements they use.”

Six tools and a taxonomy

All read-only. Filters take the same words as the site, like onboarding, paywall or bottom-sheet.

search_flows
Find flows by task, like onboarding, checkout or cancelling, across every app. Filter by flow type, category, app or platform.Free and Pro
search_screens
Find screens by pattern, UI element, state, theme, app or the text on them. Each result has its tags, a summary and a preview.Free and Pro
get_flow
Every step of one flow in order, with the transition and trigger between steps. Takes a flow id from search_flows.Pro. Free accounts get each app’s free sample flow.
get_screen
One screen in detail: each UI element with its role, variant and count, the real text from its Figma layers, and the flows it is in.Pro. Free accounts get screens from free apps, without layer text.
list_apps
The apps in the catalogue, with the slug to filter by, platform, categories and how many flows and tagged screens each has.Free and Pro
get_tokens
An app’s colour, type, radius and spacing. Coming soon: until token data is published it answers “coming soon”.Pro, coming soon
sdui://taxonomy
A resource, not a tool: every flow type, pattern, element, state and category slug the filters accept.Free and Pro

Plans and limits

Limits apply to your account, shared by all your keys, and reset at 00:00 UTC. When one is reached, your agent is told in plain words, so it stops rather than retrying.

MCP limits on the free and Pro plans
FreePro
Tools
search_flows, search_screens, list_apps; get_flow and get_screen for free apps and sample flowsEvery tool
Tool calls a day
20500
Screens and flows a day
2002,500
Results per search
Up to 10Up to 25
Previews
Thumbnails (256 px wide)Full size (1080 px wide)
Real layer text
NoYes
Requests a minute
6060

MCP Pro is included in the Pro plan, from $20/mo billed yearly. There’s no separate plan. See pricing.

Terms of use

Results are licensed under the SuperDuper licence as design reference for your own product work. Using the MCP server also means:

  • No AI training. Don’t use results to train, fine-tune or evaluate AI models, or to build datasets.
  • No bulk export. Don’t scrape, mirror, archive or resell the catalogue, or page through it to copy it. The limits enforce this.
  • No impersonation. Adapt patterns to your own brand. Don’t rebuild another company’s app, logo or login screens to pass as theirs.
  • Keys are personal. Don’t share or publish your key. We may revoke keys that break these terms.
  • Brands. App names are trade marks of their owners and appear for reference only. SuperDuper is not affiliated with or endorsed by them, and results carry no logos.
  • Logs. For 90 days we keep a record of each call: the key, the tool and the ids of the screens or flows returned. We use it to apply limits and to answer rights holders. We don’t store what you search for, and your prompts never reach us.

Rights holder? Contact us.

Create your key.

Free accounts can search straight away. Pro adds every flow and screen, real layer text and higher limits.