Project Management Tools

Tools for managing multiple design projects. Each user can have multiple projects, and MCP tools always operate on the active project.

list_projects

List all your projects with names, IDs, and active status.

Parameters: None

Returns: JSON with project list

{
  "projects": [
    {
      "id": "6789abcdef012345",
      "name": "Instagram Campaign",
      "canvasSize": "1080x1080",
      "updatedAt": "2026-02-24T10:30:00.000Z",
      "isActive": true
    },
    {
      "id": "abcdef0123456789",
      "name": "YouTube Thumbnails",
      "canvasSize": "1280x720",
      "updatedAt": "2026-02-23T15:00:00.000Z",
      "isActive": false
    }
  ],
  "count": 2
}

Example prompt: "Show me all my projects"


create_project

Create a new project. Optionally clone elements from an existing project as a template.

Parameters:

Name Type Required Description
name string No Project name (default: "Untitled Design")
cloneFromId string No Project ID to clone elements from

Returns: JSON with created project info

{
  "success": true,
  "project": {
    "id": "new-project-id",
    "name": "My New Design",
    "elementCount": 0
  },
  "message": "Created new project \"My New Design\""
}

Creating a blank project

Example prompt: "Create a new project called 'March Campaign'"

Cloning from a template

When you provide cloneFromId, all elements from the source project are copied to the new project with new UUIDs. This is useful for:

Example prompt: "Clone my Instagram Campaign project as 'March Version'"

{
  "name": "March Version",
  "cloneFromId": "6789abcdef012345"
}

The new project automatically becomes the active project, so subsequent MCP tool calls will operate on it.


switch_project

Switch the active project. All MCP tools (add_element, get_screenshot, export_canvas, etc.) operate on the active project.

Parameters:

Name Type Required Description
projectId string Yes Project ID to switch to

Returns: JSON with switched project info

{
  "success": true,
  "project": {
    "id": "abcdef0123456789",
    "name": "YouTube Thumbnails",
    "canvasSize": "1280x720",
    "elementCount": 8
  }
}

Example prompt: "Switch to the YouTube Thumbnails project"

Tip: Use list_projects first to see available project IDs, then switch_project to change the active project.


Workflow Examples

Batch Design with Templates

  1. Design a template project with placeholder text
  2. Use list_projects to get the template's ID
  3. Use create_project with cloneFromId to create a copy
  4. Use update_element to change the text/images in the copy
  5. Use export_canvas to export the finished design
  6. Repeat steps 3-5 for each variation

Example prompt: "I have a quote card template. Create 5 variations with different quotes and export each one."

Multi-Project Workflow

"List my projects"
→ list_projects

"Switch to the Instagram Campaign project"
→ switch_project { projectId: "..." }

"Add a new text element..."
→ add_element { ... }

"Now switch to YouTube Thumbnails and do the same"
→ switch_project { projectId: "..." }
→ add_element { ... }