mcpField
U
UX Pilot

UX Pilot

Remote
uxpilot.aiMedia & Design0Updated 5d ago

About UX Pilot

UX Pilot MCP connects AI clients to a UX Pilot workspace for design work, reviews, and React prototyping. It supports workspace management and importing external HTML or URLs, with hosted access and sign-in or API-key authentication.

Key features

  1. 01Create and organize pages and workstreams
  2. 02Import HTML and live URLs as designs
  3. 03Run UX and accessibility reviews
  4. 04Manage versions and comments
  5. 05Generate and publish React prototypes

Use cases

  1. 01Bring AI-generated HTML into a design workspace
  2. 02Review a design for UX and accessibility issues
  3. 03Track design changes and feedback
  4. 04Create and publish a React prototype

MCP support

The hosted MCP server exposes 77 tools for managing UX Pilot workspaces, designs, reviews, versions, comments, and prototypes. MCP clients connect over Streamable HTTP using OAuth sign-in or a bearer API key.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp.uxpilot.net/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

UX Pilot MCP

Work directly inside UX Pilot from Claude, ChatGPT, Cursor, Codex, and other MCP clients.

Bring AI-generated work into UX Pilot, organize it, review and version it, build prototypes, then switch back to UX Pilot AI for deeper product-aware generation.

MCP Website


The UX Pilot MCP server connects any MCP-compatible AI client to your UX Pilot workspace. Your assistant can create workstreams and pages, import HTML or live URLs as designs, run UX and accessibility reviews, manage versions and comments, and generate React prototypes, all inside UX Pilot.

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: 77

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

Native connector (recommended):

  1. Open Claude settings and add a custom connector / remote MCP server.
  2. Paste the server URL: https://mcp.uxpilot.net/mcp
  3. Choose the UX Pilot sign-in flow when Claude offers it and approve access.
  4. In a conversation, ask Claude to list UX Pilot tools.

API key fallback (Claude Desktop, via mcp-remote): edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json)

{
  "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"
      }
    }
  }
}

Requires Node.js. mcp-remote bridges stdio to Streamable HTTP.

ChatGPT

Use ChatGPT's custom connector / MCP support (Developer mode, availability depends on your plan):

  1. Open ChatGPT settings and add a custom connector / MCP server.
  2. Paste the server URL: https://mcp.uxpilot.net/mcp
  3. Complete the UX Pilot sign-in when prompted.
  4. Enable the connector in a chat and ask ChatGPT to list UX Pilot tools.
Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Adding the URL alone triggers native sign-in if supported; the header is the API key fallback.

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

Add to .vscode/mcp.json:

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

Add to ~/.codeium/windsurf/mcp_config.json:

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

Add to ~/.codex/config.toml:

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

Then export the raw key (no Bearer prefix; Codex adds it):

export UXPILOT_API_KEY="ep_your_api_key"
Any MCP client

Clients that do not speak Streamable HTTP can bridge through mcp-remote:

{
  "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

77 tools, grouped by what they do. Tools marked · credits consume account credits; credit-consuming and destructive actions require explicit confirmation.

Discover and inspect (12)
ToolDescription
list_workstreamsList your workstreams/folders with page summaries
list_pagesList your pages with URLs, counts, and thumbnails
get_page_contextGet a page's groups, designs, canvas, and comments
get_designGet one design's details, preview URL, optional HTML
get_design_previewGet a design's preview/page URL and status (no HTML)
get_design_versionsGet a design's version/parent family
list_design_collectionsList your custom design-system collections
get_design_collectionGet a collection's assets, styles, and docs
list_themesList available brand/style themes
get_themeGet a theme's full JSON for on-brand output
list_symbolsList reusable editor components/symbols
get_symbolGet a symbol's HTML/CSS content
Organize your workspace (19)
ToolDescription
create_workstreamCreate a workstream/folder
update_workstreamRename or re-describe a workstream
delete_workstreamDelete a workstream and detach its pages
create_pageCreate a blank page
create_page_from_templateCreate a page/group from a template
update_pageUpdate page name, prompt, or AI context
delete_pageDelete a page
move_page_to_workstreamMove a page into or out of a folder
toggle_page_bookmarkBookmark or unbookmark a page
create_groupCreate a design group on a page
update_groupUpdate a group's name, font, or designs
delete_groupDelete a group and its designs
move_group_to_pageMove a group and its designs to another page
set_group_savedSave or unsave a group to your library
duplicate_designDuplicate a design onto a page/group
move_design_to_pageMove a design to another page/group
archive_designArchive and detach a design
update_design_metadataUpdate a design's title, prompt, position, size
set_design_savedSave or unsave a design to your library
Generate with UX Pilot AI (5)
ToolDescription
generate_designGenerate one screen from a prompt · credits
plan_design_flowPlan a multi-screen flow for review (no credits)
confirm_design_flowGenerate the confirmed multi-screen flow · credits
get_generation_statusPoll generation, import, and build status
retrieve_designsPoll status/URLs/HTML for designs (legacy)
Bring in external AI output (15)
ToolDescription
import_html_designImport external HTML as a previewable design · credits
import_live_urlCapture a public URL as a design · credits
add_canvas_assetsAdd URL-backed image/reference assets to a page
upload_canvas_assetUpload base64/data-URL images to a page
update_canvas_assetsUpdate existing canvas assets and linked items
delete_canvas_assetsDelete canvas assets
add_canvas_itemsAdd sticky notes, annotations, and flow nodes
update_canvas_itemsMove, relabel, or restyle canvas items
delete_canvas_itemsDelete canvas items
generate_flowchartGenerate a flowchart graph from a prompt
edit_flowchartEdit an existing flowchart from an instruction
list_diagramsList saved diagrams on a page
create_diagramCreate a saved sitemap/journey/process diagram
update_diagramUpdate a diagram's metadata, nodes, or edges
delete_diagramDelete a diagram
Review, audit, and accessibility (8)
ToolDescription
run_ux_reviewRun a UX review, persist findings as comments · credits
get_review_statusPoll an async UX review job
apply_ux_review_fixesApply review findings as a child version · credits
run_persona_auditRun a persona-based audit, persist findings
apply_persona_audit_fixesApply persona findings as a child version · credits
save_accessibility_reportSave an external axe-style a11y report
apply_accessibility_fixesApply a11y violations as a child version · credits
compare_review_scoresCompare before/after review scores (read-only)
Versions and comments (12)
ToolDescription
create_design_versionCreate a version preserving parent history
compare_design_versionsCompare two designs/versions (metadata + HTML diff)
create_version_from_commentsCreate a child version from fixed HTML and comments
create_commentComment on a page or anchored to a design/shape
update_commentEdit your comment's text, mentions, or position
delete_commentDelete a comment and its replies
reply_to_commentReply to a comment thread
update_comment_replyEdit your reply
delete_comment_replyDelete a reply
resolve_commentResolve or reopen a comment
resolve_comments_with_version_summaryReply to and resolve comments with a version summary
summarize_commentsList and summarize page comments
Prototype and publish (5)
ToolDescription
generate_react_prototypeGenerate a React app from designs · credits
edit_react_prototypeEdit an existing prototype
build_react_prototypeQueue a build/publish refresh for a prototype
publish_prototypePublish a prototype as a hosted URL
publish_design_previewPublish a design's HTML as a hosted preview · credits

Plus request_action_confirmation, a safety utility that mints a confirmation token for risky actions.

Quick start

  1. Pick the AI client you want to use with UX Pilot.
  2. Use the native sign-in steps above with the server URL.
  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: "Create a UX Pilot page, import this HTML as a design, then run a UX review."

Support

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.