Shot Canvas

Shot Canvas MCP

Let Claude, Cursor, Codex or any app that speaks MCP design with you on the canvas. Your agent gets one tool per canvas command, and you watch every change land live and edit the same layers by hand.

  1. Two ways in
  2. Cloud connector
  3. Local MCP
  4. Your first design
  5. Working together
  6. Links and “this”
  7. Tool reference
  8. Connected apps
  9. Troubleshooting

Two ways in

Both give your agent the same tools. On a computer, the local MCP is all you need: it works in your shared canvases too, once you sign in. The cloud connector is for apps that can't run it.

Cloud connectorLocal MCP
ReachesYour shared canvases, and new ones it startsCanvases saved on this computer, and your shared canvases
AccountYes. The app signs in once and stays connectedOnly for shared canvases: the first time, your agent gives you a link to sign in
Works fromAny app, on any deviceApps on this computer. Needs Node.js 20 or later
Addresshttps://mcp.shotcanvas.io/mcpnpx -y shot-canvas mcp

Got a shared canvas link (shotcanvas.io/canvas/…)? Either works: the local MCP sends its calls through the cloud. A canvas on this machine (…?local=true or localhost)? The local MCP. If you have both installed, your agent should use the local one.

Cloud connector shared canvases

A remote MCP server (streamable HTTP) at https://mcp.shotcanvas.io/mcp. The first time, your app opens a browser to sign in to Shot Canvas and Allow. New canvases it creates are restricted: only you can open them until you invite someone or turn on link access.

Claude (claude.ai or the desktop app)

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Shot Canvas and give it this address:
    https://mcp.shotcanvas.io/mcp
  3. Press Connect, sign in and Allow. It shows up in Claude Code too.

Claude Code

  1. Add it for all your projects:
    claude mcp add --scope user --transport http shot-canvas-cloud https://mcp.shotcanvas.io/mcp
  2. In Claude Code, run /mcp, pick shot-canvas-cloud and Authenticate.

Cursor and VS Code

Use the one-click buttons on shotcanvas.io/agents, then press Connect (Cursor) or start the server when asked (VS Code), and sign in.

Codex

  1. Add it to ~/.codex/config.toml:
    [mcp_servers.shot-canvas-cloud]
    url = "https://mcp.shotcanvas.io/mcp"
  2. Sign in:
    codex mcp login shot-canvas-cloud

Any other app

Add https://mcp.shotcanvas.io/mcp as a remote MCP server (streamable HTTP) and sign in when it asks.

Local MCP canvases on this computer

No account. Your agent starts Shot Canvas on this computer, and your canvases are files in ~/.shot-canvas/files until you share them.

Claude Code and Codex, with the skill

npx -y shot-canvas install

This adds the shot-canvas MCP server to both apps for every project, and installs the Shot Canvas skill, which teaches the agent when and how to design on the canvas. On a Mac it also starts the local helper when you log in.

Any other app

claude mcp add --scope user shot-canvas -- npx -y shot-canvas mcp

Or, in an app's JSON config:

{
  "mcpServers": {
    "shot-canvas": { "command": "npx", "args": ["-y", "shot-canvas", "mcp"] }
  }
}
Options and how it runs

The local helper is a small server on 127.0.0.1:5180 that answers only to this machine. It keeps the files, routes agents, and serves the canvas at http://localhost:5180. The MCP server starts it when nothing answers.

  • --name "My agent" sets how the agent shows to you on the canvas.
  • --canvas <space> makes it prefer one canvas.
  • SHOT_CANVAS_BROWSER=system lets openCanvas open your default browser. The default is none: the agent opens the canvas in its own in-app browser.

Your first design

Just ask for something visual: “mock up a sign-up flow and make it clickable”. A well-behaved agent will:

  1. Start a canvas. createDocument({ name }) makes a new canvas with one empty page and binds the agent's calls to it. To continue an existing one, listDocuments then openCanvas.
  2. Open it where you can see it. The agent opens the returned address in its own in-app browser (Claude Code's Browser pane, Codex's in-app browser), beside the chat. It shouldn't launch your default browser unless you ask.
  3. Build. write({ html }) turns HTML and CSS into editable native layers with auto layout, a whole screen in one call. Repeated UI becomes one component with instances.
  4. Check its work. renderFramePng renders a frame exactly as it exports, so the agent can look before it tells you it's done.
  5. Hand back a link. linkTo gives a link to the frame or page it made.

Working together

Copy link (beside History) copies a link to what's selected, or to the page. Paste it to an agent in any app: openLink points its calls at that canvas and page, and tells it which frame and layers the link means. That's what “this” is.

To move a local canvas to the cloud, use Share in the canvas, or have the local agent call shareDocument. From then on, the local agent's calls for it go through the cloud.

Tool reference

Each canvas command is a typed MCP tool with a description and a JSON Schema for its arguments. describeCommands lists them all from inside a session. Grouped here by what they're for.

Canvases and pages
createDocumentStart a new canvas with one empty page, and bind calls to it
listDocumentsYour canvases (local: saved on this machine; cloud: owned, invited to or opened by link)
openCanvasOpen or resume a canvas and bind later calls to it
openLink · linkTo · describeLinkFollow a link you were given; hand one back
listCanvases · useCanvasLocal: the windows open now, and which one calls go to
shareDocument · shareFolderLocal: move a canvas or folder to the cloud
renameDocumentRename the canvas
listPages · addPage · switchPage · usePagePages within the canvas
renamePage · duplicatePage · deletePage · reorderPages · clearPageManage pages
startTask · endTaskGroup changes under a name in History
Reading the canvas
getContextYour page, selection and view, and who is working where
getStateThe page's layers: whole for a small page, an outline in parts for a big one
findLayers · listFrames · getWeightFind layers; list frames; how heavy a page is
listComponents · listStyles · listVariables · listFontsWhat the canvas has to reuse
getHistory · getCapabilities · describeCommandsRecent changes; layer types, tools and presets the canvas offers; every command
Building
writeBuild a whole screen from HTML/CSS as editable layers with auto layout, in one call
run · batchA script, or several commands, as one all-or-nothing change
addFrame · setFrameSize · removeFrame · setGap · setOutputSizeFrames (artboards)
addText · setTextStyle · createLayer · addImageFromDataUrl · addFile · importSvgText, shapes, images, files and SVG
updateElement · updateElements · deleteElement · duplicateElementChange or remove layers
moveLayers · groupLayers · alignLayers · distributeLayers · addAutoLayoutArrange and lay out
setEffects · setMask · booleanLayers · setVectorNetwork · drawFreehandEffects, masks and vectors
importClaudeDesignBring in a Claude Design canvas as editable frames
Design systems
createComponent · createInstance · combineAsVariants · setVariant · swapInstanceComponents and variants
createStyle · applyStyle · updateStyleFill, text, effect and grid styles
createVariableCollection · createVariable · bindVariable · setVariableModeVariables and modes, like Light and Dark
setControls · setControlValueControls: settings you adjust in the inspector
listSkills · runSkill · saveSkill · connectLibrarySkills: reusable recipes, with a button each
Seeing, prototyping and exporting
renderFramePng · renderLayersPng · renderViewPng · renderLayersSvgRenders for the agent to look at
addInteraction · setFlowStart · getPrototype · play · stopPlayClickable prototypes and Play
exportDocument · exportFrame · exportFramesPdf · exportAllZip · copyAsPNG, JPG, SVG, PDF and CSS, to your downloads or clipboard
fitView · zoomToLayers · selectShow you something on screen
Comments and history
listComments · addComment · reply · reactToComment · resolveCommentComment threads, as the agent itself
undo · redoThe agent's own changes only
moveToArchive · archivePage · restoreFromArchive · freezeFramesKeep heavy canvases fast
Tools (extending the canvas)
installTool · installToolFromUrl · describeToolFormatAdd a new way to draw: one sealed script that calls defineTool
listTools · setToolHidden · moveTool · removeToolManage the toolbar

Shared canvases respect roles. Through a viewer's access, an agent gets only reading, the view, Play and exports. Commenters can comment and react.

Connected apps

Signed in at shotcanvas.io/agents, you'll see every app connected to your account. Disconnect signs that app out: it has to sign in again to work in your canvases.

Troubleshooting

Need a hand? See Help or email support@shotcanvas.io.