MCP Quickstart

1. Get Your API Key

Go to Settings → API Keys in the dashboard. Click "Generate Agent Key" and copy it. The key format is lf_agent_xxxxxxxxxxxx.

2. Get Your MCP URL

Go to Connections (/connections). Your MCP endpoint URL is displayed there:

https://livefolio.cloud/api/mcp

3. Configure Your Agent

Claude Code

Add to ~/.claude/claude_desktop_config.json or your project's .mcp.json:

{
  "mcpServers": {
    "livefolio": {
      "url": "https://livefolio.cloud/api/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer lf_agent_xxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Add to Cursor's MCP settings (Settings → MCP → Add Server).

GitHub Copilot

Add to Copilot's MCP configuration in your workspace settings.

Gemini CLI

gemini mcp add livefolio https://livefolio.cloud/api/mcp \
  --header "Authorization: Bearer lf_agent_xxxxxxxxxxxx"

4. Test It

Ask your agent:

"List my LiveFolio projects."

It should call list_projects and show your folios (or an empty list if you haven't created any yet).

5. Create Your First Folio

Ask your agent:

"Create a LiveFolio project called 'Hello MCP' with a simple HTML page that says Hello World in large centered text."

Check your dashboard — the folio should appear immediately.

Verify Everything Works

Run through these prompts to confirm full functionality:

1. "List my LiveFolio projects" — tests list_projects
2. "Create a LiveFolio folio called 'Test' with a hello world HTML page" — tests create_project
3. "Get the full details of the Test project" — tests get_project
4. "Update the Test project — change the heading color to blue" — tests update_project

All four working? You're ready to go.

Self-Hosted Setup

Running your own instance? See Self-Hosting: MCP Configuration for local setup, tunnel configuration, and OSS-specific MCP tools.