UX Pilot

The UX Pilot MCP server connects any MCP-compatible AI client to your UX Pilot workspace. Version 3.0 has 15 general tools. Each one covers a kind of work (find, read, edit, review, export and so on), and you choose the action inside the tool. That keeps the tool list short and leaves more of your AI's context for the work.

The server is hosted by UX Pilot. This repository documents how to connect to it and what it exposes. There is no server code here to build or run.

• Server URL: https://mcp.uxpilot.net/mcp
• Transport: Streamable HTTP (POST)
• Protocol: MCP 2025-11-25 (JSON-RPC 2.0)
• Auth: Native OAuth sign-in (recommended), or Authorization: Bearer API key fallback
• Tools: 15 (version 3.0)
• Free plan: connect with a free UX Pilot account and get 50 actions a week

What your AI can do

• Design on the canvas, live. Your AI places a screen as HTML, then builds it one section at a time while you watch it appear on the open canvas. Each step comes back with a picture of the result, and design checks point out problems with fixes.
• Run UX Pilot's design agent. Hand a brief to UX Pilot's own agent for screens, whole flows or a React app, on the standard, pro or ultra tier. Or mix the two: the agent drafts and your AI refines.
• Review. UX reviews, persona reviews, attention heatmaps and gaze flow, on a UX Pilot screen, raw HTML or a live URL. Heatmaps and gaze flow also take a screenshot. Fixes land as a new version.
• Make videos and media. Product reels, ads, explainers, social clips and logo animations, exported as MP4, WebM or GIF. Images, image edits, voiceovers, music and sound effects.
• Use your design system. Import one from code, a repository, a website or tokens, then design on brand with its guide.
• Ship. Turn screens into a React app, edit its files, publish it, or share a public preview link.
• Organize. Pages, folders, groups, versions, canvas notes, diagrams and comments.

Free plan

Free UX Pilot accounts can connect and use every tool:

• 50 actions a week that write or run something (imports, edits, organizing, designs, reviews, media, videos). Reading, searching, checking jobs and stopping runs are not counted. The week resets Monday 00:00 UTC.
• Design runs use the standard tier. Some features need a paid plan, the same as in the app. When one does, the tool says what is needed and links to the plans.
• AI runs spend credits, as they do in the app.

Paid plans have no weekly action limit. See uxpilot.ai/plans.

Authentication

Native sign-in (recommended)

If your AI tool shows a UX Pilot sign-in or authorization screen, choose that flow. You log in with your UX Pilot account, review the requested access, and approve the connection. No API key to copy or paste, and access stays tied to your account and plan.

API key fallback

For clients that only support static headers, generate a key from the API Keys tab in your UX Pilot workspace and send it as a bearer token:

Authorization: Bearer ep_your_api_key

Enterprise workspaces: your admin manages MCP/API keys. Keep the key private and rotate it if access changes.

Setup

Prefer native sign-in wherever the client supports it. Use the API key config as a fallback. Replace ep_your_api_key with your real key.

claude mcp add --transport http uxpilot https://mcp.uxpilot.net/mcp

{  "mcpServers": {    "uxpilot": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mcp.uxpilot.net/mcp",        "--transport",        "http-only",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer ep_your_api_key"      }    }  }}

{  "mcpServers": {    "uxpilot": {      "url": "https://mcp.uxpilot.net/mcp",      "headers": {        "Authorization": "Bearer ep_your_api_key"      }    }  }}

{  "servers": {    "uxpilot": {      "type": "http",      "url": "https://mcp.uxpilot.net/mcp",      "headers": {        "Authorization": "Bearer ep_your_api_key"      }    }  }}

{  "mcpServers": {    "uxpilot": {      "serverUrl": "https://mcp.uxpilot.net/mcp",      "headers": {        "Authorization": "Bearer ep_your_api_key"      }    }  }}

[mcp_servers.uxpilot]url = "https://mcp.uxpilot.net/mcp"bearer_token_env_var = "UXPILOT_API_KEY"

export UXPILOT_API_KEY="ep_your_api_key"

{  "mcpServers": {    "uxpilot": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mcp.uxpilot.net/mcp",        "--transport",        "http-only",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer ep_your_api_key"      }    }  }}

Tools

15 tools. Most take a kind or action that picks what to do, and a params object with that action's fields. Ask the server with guide({ topic: "<tool>.<action>" }), for example guide({ topic: "edit.patch" }), for an action's fields and an example.

Confirmation

Calls that spend credits, publish or delete stop and ask first:

1. The first call answers with a summary and a confirmationToken instead of running.
2. Your AI tells you what will happen and asks.
3. If you agree, it calls again with the same params plus confirmed: true and the token. The token is tied to that exact call and expires after 15 minutes.

Upgrading from 2.x

Version 2.x listed 87 separate tools, such as search_designs, start_design_agent and patch_design_html. Nearly all of them are now actions of a 3.0 tool, and guide({ topic: "names" }) maps every old name to its new call. For example, search_designs is find with kind designs, start_design_agent is design with action agent, and patch_design_html is edit with action patch. The old tool list is still served at https://mcp.uxpilot.net/mcp?toolset=legacy for now, and it will be removed in a later release.

Quick start

1. Pick the AI client you want to use with UX Pilot.
2. Add the server URL with the native sign-in steps above.
3. If your client needs static headers, generate an API key and replace ep_your_api_key in the fallback config.
4. Ask your assistant, for example:
   • "Design a pricing page for my app on the UX Pilot canvas, one section at a time."
   • "Have UX Pilot's design agent make a 3-screen onboarding flow on the pro tier."
   • "Run a UX review on my checkout screen in UX Pilot and fix what it finds."
   • "Make a 15-second 9:16 product reel for my app and export it as MP4."

Support

• Product and account help: uxpilot.ai
• MCP overview: uxpilot.ai/mcp
• Issues with this integration: open an issue
• MCP specification: modelcontextprotocol.io