Canvas MCP tools

Documentation Index

Fetch the complete documentation index at: https://canvas-docs.vibeflow.ai/llms.txt

Use this file to discover all available pages before exploring further.

These are the tools exposed by the VibeFlow MCP server that touch the canvas product. They’re available to any MCP-compatible client connected via the MCP overview. The broader VibeFlow MCP also exposes UI-project and design-system tools (initiate_project, deploy_project, create_design_system, etc.). Those are documented separately at docs.vibeflow.ai.

---

​

Canvas tools

​

list_canvases

Lists every canvas in your account (or organization, if your key is org-scoped). Returns an array of { id, name, organizationId, createdAt, updatedAt }.

---

​

get_canvas

Returns a single canvas’s metadata, including attached design system and style. Returns { id, name, designSystemIds, selectedStyle, ... }.

---

​

list_canvas_frames

Lists every frame on a canvas. Returns an array of { frameId, x, y, width, height, z, name?, htmlPreview? }.

---

​

get_canvas_frame_code

Returns the raw HTML of a single frame. Useful before calling update_canvas_frame so the AI can patch surgically. Returns { html, width, height, ... }.

---

​

create_canvas_frame

Adds a new frame to a canvas with full HTML, size, and position. Returns { frameId }.

---

​

write_canvas_frame

Replaces the full HTML of an existing frame. Used when you want to re-render the whole frame rather than touch one element. Returns { ok: true }.

---

​

update_canvas_frame

Patches one or more elements inside a frame using stable element selectors. Prefer this over write_canvas_frame when you only need surgical edits. Equivalent to the canvas agent’s update_element tool. Returns { ok: true, applied: number }.

---

​

delete_canvas_frame

Removes a frame from a canvas. Cannot be undone via MCP. (The in-app undo stack does not see MCP deletes.) Returns { ok: true }.

---

​

run_canvas_agent

Runs the full canvas agent with the same tool surface, brand contract, and credit gating as the in-app chat. The agent decides which canvas tools to call based on your brief. Returns a streamed series of events (frame creates, element updates, narration), then a final { creditsUsed, summary }.

---

​

Skill tools

​

list_canvas_skills

Lists skills loaded for a canvas. Includes the attached design system (compiled to a skill) and any user-enabled skills. Returns an array of { skillId, name, source }.

---

​

load_canvas_skill

Returns the full SKILL.md and reference files for one skill. Useful if your client wants to display the brand contract before generating. Returns { skillMd, references: [{ path, content }] }.

---

​

Export tools

​

export_canvas

Kicks off an export job. Returns a job id you poll with get_canvas_export. Returns { jobId }.

---

​

get_canvas_export

Polls an export job. Returns the status and, when done, a signed download URL valid for a short window. Returns { status, downloadUrl?, error? }. status is one of pending, ready, or failed.

---

​

Auth + errors

Every tool requires a valid Authorization: Bearer YOUR_API_KEY header. Common errors:

​

Next