# Subframe MCP MCP Server

> **Subframe MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Subframe MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/subframe-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Generate and refine UI designs with Subframe through AI assistants. Create polished React components and responsive layouts from natural-language prompts, explore design variations, and turn design concepts into production-ready code.

---

## Details

- Server ID: `subframe-mcp`
- Version: 0.1.0
- Tools: 70
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Subframe MCP has to be in the toolset
first. In order:

1. Add Subframe MCP to your toolset at https://mewcp.com/mcp/subframe-mcp
2. Connect your Subframe MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (70)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `open_editor_session` _(write)_ — Used by the Subframe widget, not for direct use. Returns a short-lived credential for the embedded Subframe editor, which opens on this project.
- `open_subframe` _(read)_ — Design work isn’t done until the user has seen it. Your text can’t show how a design looks, and the user often wants to adjust something by hand rather than…
- `list_projects` _(read)_ — Lists all projects the user has access to. Call this tool to find a projectId if the user has not specified one and does not have a sync.json file. If the user…
- `create_project` _(write)_ — Creates a project in one of the user's teams and returns its projectId for subsequent tool calls. Use it when list_projects returns no projects or the user…
- `get_project_info` _(read)_ — Gets project information including design documentation. Each project document has an id, title, isPinned and contents; the pinned document is the project's…
- `get_theme` _(read)_ — Returns one theme as typed JSON (the default theme unless themeId selects another), plus responsive breakpoints and available font families. Token values use…
- `list_themes` _(read)_ — Lists the project's themes with their ids and which one is the default theme (it cannot be deleted). A project can hold several themes that share token names…
- `search_icons` _(read)_ — Search the project's icons (built-in Lucide icons and uploads) by describing what you want (e.g. 'warning triangle', 'shopping cart'). Projects differ in which…
- `edit_theme` _(destructive)_ — Edit a project's theme with a batch of typed operations: create, update, rename or delete tokens (color, typography, corner, shadow, border; breakpoints can be…
- `import_theme` _(destructive)_ — Imports a theme into a project from source you paste: Tailwind v4 CSS (@theme blocks, :root variables, a .dark block for dark mode, @custom-variant max-width…
- `get_canvas_info` _(read)_ — Gets information about a canvas, including the page IDs that belong to it. A canvas is a collection of related pages organized together (e.g. 'Onboarding',…
- `list_components` _(read)_ — Lists all components and page layouts in the project and the folder each is filed in. Use list_folders to see the folders themselves.
- `list_folders` _(read)_ — Lists every folder in the project, including empty ones, with the components and page layouts filed in each. Folders group components — e.g. by release phase;…
- `list_pages` _(read)_ — Lists all pages in the project.
- `list_canvases` _(read)_ — Lists all canvases in the project. A canvas is a collection of related pages organized together (e.g. 'Onboarding', 'Settings', 'Checkout'). Use this to…
- `list_snippets` _(read)_ — Lists all snippets in the project. Snippets are reusable designs typically embedded in design documents as examples.
- `get_component_info` _(read)_ — Generates the code and other info for a component. By default, files contain standard export-faithful component code. Set includeEditorMetadata only for…
- `get_page_info` _(read)_ — Generates the code for a page. One of id, name, or url must be provided. Example page id: dfe2fb91-f350-4db0-8c71-9d3dd0ee6a9c. Example page names:…
- `get_snippet_info` _(read)_ — Generates the code and other info for a snippet. Snippets are reusable designs typically embedded in design documents as examples. One of id, name, or url must…
- `design_page` _(write)_ — Have Subframe's AI generate 1-4 page variations as a background job. To write a page yourself, use create_page then edit_page; use this when the user asks for…
- `edit_page` _(destructive)_ — Apply a targeted edit to one node of an existing Subframe page. Pass the nodeId you want to change, calling get_page_info with includeNodeIds: true only if you…
- `create_page` _(write)_ — Place a new empty page on a canvas, for you to fill with edit_page. No Subframe AI runs. Call it once you've read what you need and are ready to write, right…
- `get_design_guidance` _(read)_ — Get Subframe's reference by topic: pages (the JSX and Tailwind subset Subframe parses into an editable page, page structure, responsive styling, popup…
- `get_implementation_guidance` _(read)_ — Get Subframe's guidance for implementing designs in a codebase: component ownership (Subframe sync or the app's own components), getting the code, and…
- `design_component` _(destructive)_ — Have Subframe's AI design a new component, or edit an existing one when component is given, as a background job. Use it only when the user asks for Subframe's…
- `create_component` _(write)_ — Create a new component for you to build with edit_component. No Subframe AI runs. Omit `from` for an empty component, or pass a template or project component…
- `edit_component` _(destructive)_ — Change an existing component's code yourself. No Subframe AI runs. Edit the code from get_component_info with includeEditorMetadata: true (or from an earlier…
- `design_snippet` _(write)_ — Design a snippet in Subframe. Snippets are small bits of reusable UI typically embedded in design documents as examples (e.g., a Button example showing all…
- `create_snippet` _(write)_ — Create a new empty snippet, for you to fill with edit_snippet. No Subframe AI runs. Snippets are small bits of reusable UI typically embedded in design…
- `edit_snippet` _(destructive)_ — Apply a targeted edit to one node of an existing Subframe snippet. First call get_snippet_info with includeNodeIds: true to see each element's data-node-id,…
- `update_node_styles` _(destructive)_ — Apply the same complete Tailwind className to one or more elements on a single existing Subframe page or snippet without touching their structure or content.…
- `wait_for_jobs` _(read)_ — Wait for background AI jobs to finish. Pass the jobIds returned by any relevant tools. Each status is 'running' (still working), 'done' (finished with at least…
- `delete_page` _(destructive)_ — Delete a page from the project. The page is removed from any canvas it belongs to and prototype actions referencing it are stripped. By default, refuses if the…
- `delete_component` _(destructive)_ — Delete a component or custom page layout from the project. Deleting a component removes access to its component-level version history. Restoring it requires…
- `delete_snippet` _(destructive)_ — Delete a snippet from the project. Any embeds in design docs (`<div data-component-id>` blocks) are scrubbed automatically. Deletion is irreversible from MCP —…
- `delete_theme` _(destructive)_ — Delete a theme from the project. The default theme cannot be deleted: every project keeps it, so it is also the last theme left. Pages and components do not…
- `delete_canvas` _(destructive)_ — Delete a canvas from the project. By default, refuses if the canvas contains any pages — pass "deleteChildPages: true" to delete the canvas and every page…
- `delete_folder` _(destructive)_ — Delete a folder from the project. By default, refuses if the folder contains any components or page layouts — pass "deleteContents: true" to delete the folder…
- `delete_project` _(destructive)_ — Deletes the project for the whole team. It can't be restored from MCP or the app. Only call this when the user asks to delete the project.
- `rename` _(write)_ — Rename a page, component, snippet, page layout, canvas, component folder, or theme. Theme ids come from list_themes. If the requested name is already taken, it…
- `move` _(write)_ — Move pages between canvases and spots on a canvas, and file components and page layouts into folders, in one call. A page move gives a canvas, a placement, or…
- `duplicate` _(write)_ — Duplicate a page, component, snippet, canvas, theme, or a whole project. For a canvas, its pages are copied but its prototype is not. Duplicating a theme is…
- `list_comments` _(read)_ — Lists design comment threads, with each thread's comments as plain text, author, and timestamps. Returns open threads by default; set includeResolved to…
- `create_asset_upload` _(write)_ — Stages one or more files for upload into a project before adding them as assets: add_icons for SVG icons, add_fonts for WOFF/WOFF2/TTF/OTF fonts, add_images…
- `add_icons` _(destructive)_ — Adds SVG files staged by create_asset_upload to the project's icon library. Flow: call create_asset_upload, POST each SVG with the request it returns, then…
- `add_fonts` _(destructive)_ — Adds font files staged by create_asset_upload to the project as custom font families. Flow: call create_asset_upload, POST each font (WOFF, WOFF2, TTF, or OTF)…
- `add_images` _(write)_ — Adds images to the project's images, hosted on Subframe's image CDN, from image URLs or from files staged by create_asset_upload. For an image at a public URL,…
- `list_icons` _(read)_ — Lists the project's uploaded icons by import name, the exact name code references (e.g. <SubframeCore.Icon name="ArrowLeft" /> or <Button icon="ArrowLeft" />).…
- `list_fonts` _(read)_ — Lists the project's fonts: Google fonts and custom fonts added with add_fonts. Every listed font is usable by name (e.g. in edit_theme). A font weight can be…
- `list_images` _(read)_ — Lists the project's images by id, name, and url. Use an image in a design by putting its url exactly as an <img> src (in edit_page or design code). Add images…
- `get_icon_info` _(read)_ — Looks up one or more icons by id (from list_icons or add_icons results). Pass ids as an array even for one icon: { ids: ["<iconId>"] }. For an uploaded icon,…
- `delete_icons` _(destructive)_ — Deletes one or more uploaded icons from the project's icon library. Pass ids as an array even for one icon: { ids: ["<iconId>"] }. Designs using a deleted icon…
- `delete_fonts` _(destructive)_ — Deletes one or more custom fonts, each replaced by another font (a Google or custom font id from list_fonts). Pass fonts as an array of objects, not bare ids,…
- `delete_images` _(destructive)_ — Deletes one or more images from the project (ids from list_images or add_images results). Pass ids as an array even for one image: { ids: ["<imageId>"] }.…
- `screenshot_component` _(read)_ — Renders a component's variants and interaction states and returns a screenshot so you can validate the result against the intended design. Use it after writing…
- `screenshot_page` _(read)_ — Renders a page and returns a screenshot of it so you can see the result and check it against the intended design. It renders the default desktop breakpoint…
- `export_image` _(read)_ — Exports a page, one element of a page, a component, or a snippet as an image file for the user and returns a download URL. Use this when the user wants an…
- `write_design_document` _(destructive)_ — Create or update a design document with markdown content. If id is provided, edits the existing document; otherwise creates a new one. Project docs are…
- `delete_design_document` _(destructive)_ — Delete a design document, either a project document or the one attached to a component. Take the id from a fresh get_project_info (project documents) or…
- `search_docs` _(read)_ — Search the Subframe Docs knowledge base for information about the Subframe product and the development workflow. ## When to use - The user asks a high-level…
- `search_inspiration` _(read)_ — Search Subframe's hand-curated library of distinctive real landing pages, chosen for their visual and art direction. Use it to break away from generic…
- `search_motion_examples` _(read)_ — Search the Subframe Motion Library for React animation examples. Describe what you want in plain words — the effect, the element, how it should feel, or, when…
- `get_motion_example` _(read)_ — Get one Subframe Motion Library example: its complete React source; how it looks and moves; adapt notes naming the code that drives the motion and what to…
- `get_motion_guidance` _(read)_ — Get Subframe's guidance for designing motion well, by topic: principles (whether to animate at all), timing (durations, curves, springs), enter-exit (menus,…
- `generate_auth_token` _(write)_ — Generates a CLI auth token for the authenticated user. Use this token with the Subframe CLI (e.g. `npx @subframe/cli init --auth-token <token>`). The token is…
- `list_prototypes` _(read)_ — Lists the prototypes in a project. A prototype is an interactive, AI-built running app (its own React/Vite codebase) created in the Subframe prototyping…
- `get_prototype_info` _(read)_ — Gets information about a single prototype, including the list of files in its standalone, runnable Vite app. Pass an id from list_prototypes. Read individual…
- `read_prototype_file` _(read)_ — Reads the contents of a single file from a prototype's standalone, runnable Vite app. Use the file paths returned by get_prototype_info.
- `submit_feedback` _(write)_ — Report a problem with Subframe's MCP tools to the Subframe team (not to the user's project or teammates). Call it at most once per task, and only when: - you…
- `finish_working` _(write)_ — Tell Subframe you are done working on a project, so collaborators with it open see you have finished. Call it once when you finish a task that read or changed…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/subframe-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/subframe-mcp/connect/chatgpt
- Grok: https://mewcp.com/mcp/subframe-mcp/connect/grok
- DeepSeek Harness: https://mewcp.com/mcp/subframe-mcp/connect/dsh
- Mistral Vibe: https://mewcp.com/mcp/subframe-mcp/connect/mistral-vibe
- VS Code: https://mewcp.com/mcp/subframe-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/subframe-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/subframe-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/subframe-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/subframe-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/subframe-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/subframe-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/subframe-mcp/connect/hermes
- Kimi Code: https://mewcp.com/mcp/subframe-mcp/connect/kimi-code
- Grok Build: https://mewcp.com/mcp/subframe-mcp/connect/grok-build
- Devin Desktop: https://mewcp.com/mcp/subframe-mcp/connect/devin-desktop
- Zed: https://mewcp.com/mcp/subframe-mcp/connect/zed
- Muse Code: https://mewcp.com/mcp/subframe-mcp/connect/muse-code
- Cline: https://mewcp.com/mcp/subframe-mcp/connect/cline
- Kilo Code: https://mewcp.com/mcp/subframe-mcp/connect/kilo-code
- Kiro: https://mewcp.com/mcp/subframe-mcp/connect/kiro
- Junie: https://mewcp.com/mcp/subframe-mcp/connect/junie
- Amp: https://mewcp.com/mcp/subframe-mcp/connect/amp
- Qwen Code: https://mewcp.com/mcp/subframe-mcp/connect/qwen-code
- Goose: https://mewcp.com/mcp/subframe-mcp/connect/goose
- Python: https://mewcp.com/mcp/subframe-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/subframe-mcp/connect/typescript