MCP Tools Reference

Complete reference for every LiveFolio MCP tool — parameters, return values, and usage examples.

list_projects

List all folios in your workspace.

Parameters: None

Returns:

{
  "projects": [
    {
      "project_id": "my-folio-1234",
      "title": "My Folio",
      "description": "A sample folio",
      "file_count": 3,
      "version_count": 5,
      "open_comments": 2,
      "updated_at": "2026-06-15T10:30:00Z",
      "share_url": "https://livefolio.cloud/share/my-folio-1234",
      "studio_url": "https://livefolio.cloud/studio/my-folio-1234"
    }
  ],
  "total": 1
}

get_project

Retrieve full details of a specific project — all files, comments, version history, and chat history.

Parameters:

Param	Type	Required
`project_id`	string	Yes

Returns: Full project object with current_files, version_history, open_comments, chats, design_preferences, project_mode, and URLs.

create_project

Publish a new folio.

Parameters:

Param	Type	Required	Description
`title`	string	Yes	Folio title
`initial_html`	string	Yes	Full HTML content
`description`	string	No	Optional description
`project_mode`	string	No	`"deck"`, `"document"`, `"spreadsheet"`, `"dashboard"`
`design_preferences`	object	No	Theme, palette, typography, custom colors, libraries

Binary files: Include images as base64 Data URLs (data:image/png;base64,...). They're automatically decoded.

Example:

{
  "name": "create_project",
  "arguments": {
    "title": "Q3 Report",
    "initial_html": "<!DOCTYPE html><html>...</html>",
    "project_mode": "document",
    "design_preferences": {
      "theme": "Premium SaaS Deck",
      "palette": "Cobalt Ocean",
      "typography": "Outfit & Roboto Mono"
    }
  }
}

Returns:

{
  "success": true,
  "project_id": "q3-report-5678",
  "share_url": "https://livefolio.cloud/share/q3-report-5678",
  "studio_url": "https://livefolio.cloud/studio/q3-report-5678"
}

update_project

Edit files in an existing project. Files are merged — only send what changed.

Parameters:

Param	Type	Required	Description
`project_id`	string	Yes	Project ID
`updated_files`	object	Yes	Map of filename → content
`change_message`	string	Yes	Description of what changed

Example:

{
  "name": "update_project",
  "arguments": {
    "project_id": "q3-report-5678",
    "updated_files": {
      "assets/style.css": "h1 { color: #1D4ED8; }"
    },
    "change_message": "Updated heading color to cobalt"
  }
}

Returns:

{
  "success": true,
  "project_id": "q3-report-5678",
  "versionId": "v3",
  "share_url": "...",
  "studio_url": "..."
}

get_curated_brief

Get a structured markdown design brief from all open reviewer comments.

Parameters:

Param	Type	Required
`project_id`	string	Yes

Returns: { title, description, brief (markdown), openComments[] }

get_active_design_system

Retrieve the complete design specification for a project: theme, palette, typography, elevation, grid, animations, mode layout, approved libraries, and quality guidelines.

Parameters:

Param	Type	Required
`project_id`	string	Yes

Returns: { usesTailwind, fonts[], themeAnalysis (markdown), projectMode, theme, palette, typography }

Self-Hosted Tools

Self-hosted instances have three additional tools for tunnel management. See Self-Hosting: Public Sharing.