Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt

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

MCP Server

Connect AI assistants to LanderLab via the Model Context Protocol. Manage landing pages, analytics, leads, and A/B tests from Claude, Cursor, Windsurf, Manus, or any MCP-compatible client.
https://api.landerlab.dev/api/v2/mcp
API key auth · 30+ tools · Works everywhere

Overview

The LanderLab MCP server gives AI assistants the ability to list landers, pull analytics, publish and unpublish pages, manage leads, run A/B tests, and more on your behalf. Instead of switching between your AI tool and the LanderLab dashboard, your assistant handles it in one conversation. Who is this for? Performance marketers, media buyers, and teams who want to manage their LanderLab account faster. Ask your AI assistant what you need in plain English and it calls the right API for you. How it works. The MCP server exposes tools that your AI assistant can call during a conversation. When you say “list my landers in workspace 1,” the assistant calls landers_list and returns the results. One server, one API key, and you are ready to go.

Get Your API Key

Before connecting any client, you need an API key.
1

Open API Keys

Log in to LanderLab and go to Organization > API Keys.
2

Create a new key

Click Create and copy the key immediately.
The key is only shown once. If you lose it, create a new one.
Your key starts with ll_live_ and looks like this:
ll_live_2f20699a_e632aa7ad57f532d2d3eca2b67d73930...

Quick Connect

Claude Code

1

Run the CLI command

Open your terminal and run:
claude mcp add --transport http landerlab \
  https://api.landerlab.dev/api/v2/mcp \
  --header "X-API-Key: ll_live_YOUR_KEY_HERE" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream"
Replace ll_live_YOUR_KEY_HERE with your actual key.
2

Verify the connection

Type /mcp in Claude Code. You should see landerlab listed. Try asking “List my workspaces” to confirm.

Claude Desktop

1

Open the config file

Find your claude_desktop_config.json:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
2

Add the server

Add this to the file:
{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}
3

Restart Claude Desktop

Close and reopen the app. LanderLab tools will be available in your next conversation.

ChatGPT (Custom GPT / MCP-Compatible Setup)

1. Get your API key

In LanderLab:
  • Go to Organization → API Keys
  • Click Create
  • Copy the API key immediately
Your key looks like:
ll_live_2f20699a_e632aa7ad57f532d2d3eca2b67d73930...

2. Configure the MCP server

Use the following MCP endpoint:
https://api.landerlab.dev/api/v2/mcp
Required headers:
{
  "X-API-Key": "ll_live_YOUR_KEY_HERE",
  "Content-Type": "application/json",
  "Accept": "application/json, text/event-stream"
}

3. Add it to your ChatGPT MCP client

If your ChatGPT environment supports MCP connections, add this configuration:
{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}

4. Verify the connection

Once connected, you can use natural language prompts like:
  • “List all my landers”
  • “Show analytics for my top converting page”
  • “Publish lander X”
  • “Show all leads from workspace 1” ChatGPT will automatically call the appropriate LanderLab MCP tools behind the scenes.

Cursor

1

Open the config file

Create or edit .cursor/mcp.json in your project root.
2

Add the server

{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}
3

Restart Cursor

The LanderLab tools will appear in your next agent session.

Windsurf

1

Open MCP settings

Go to Windsurf Settings > MCP or edit ~/.codeium/windsurf/mcp_config.json.
2

Add the server

{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}
3

Restart Windsurf

Reopen the editor and the tools will be available.

Manus

1

Open MCP settings

In Manus, go to Settings > MCP Servers (or Integrations > MCP) and click Add Server.
2

Configure the server

Fill in the connection details:
  • Name: landerlab
  • Transport: HTTP (Streamable HTTP)
  • URL: https://api.landerlab.dev/api/v2/mcp
Add the following headers:
HeaderValue
X-API-Keyll_live_YOUR_KEY_HERE
Content-Typeapplication/json
Acceptapplication/json, text/event-stream
Replace ll_live_YOUR_KEY_HERE with your actual key.
3

Save and verify

Save the configuration. In a new Manus task, ask “List my LanderLab workspaces” to confirm the tools are available.
If Manus prefers a JSON-style configuration, use:
{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}

ChatGPT

1

Open MCP settings

In ChatGPT, open Settings > Connectors > MCP Servers (or the MCP integrations area available in your workspace).
2

Add the server

Configure the MCP server with the following values:
  • Name: landerlab
  • Transport: HTTP
  • URL: https://api.landerlab.dev/api/v2/mcp
Add these headers:
HeaderValue
X-API-Keyll_live_YOUR_KEY_HERE
Content-Typeapplication/json
Acceptapplication/json, text/event-stream
Replace ll_live_YOUR_KEY_HERE with your actual key.
3

Save and verify

Save the configuration and start a new chat.Try prompts like:
  • “List my LanderLab workspaces”
  • “Show analytics for my top lander”
  • “Publish lander X”
ChatGPT will automatically call the appropriate MCP tools.
If your ChatGPT environment supports JSON-based MCP configuration, you can also use:
{
  "mcpServers": {
    "landerlab": {
      "type": "http",
      "url": "https://api.landerlab.dev/api/v2/mcp",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
        "X-API-Key": "ll_live_YOUR_KEY_HERE"
      }
    }
  }
}

## Other MCP Clients

Any client that supports the MCP HTTP transport can connect. Point it to:

```text
https://api.landerlab.dev/api/v2/mcp
Set these headers:
HeaderValue
X-API-KeyYour ll_live_... key
Content-Typeapplication/json
Acceptapplication/json, text/event-stream

Tools Reference

Your organization is auto-resolved from the API key. No need to pass an organization ID.

Read-Only

ToolDescription
workspaces_listList all workspaces
landers_listList landing pages in a workspace
domains_listList domains in a workspace
domains_list_globalList all domains across the organization
integrations_listList configured integrations
leads_listList leads for a lander
leads_list_orgList leads across the organization
variants_listList A/B test variants
api_key_listList API keys
dashboard_getGet visits, conversions, and leads stats
analytics_graphsGet graph data for a lander
analytics_statsGet detailed stats for a lander
analytics_reportsGenerate reports for a lander
reporting_getRun multi-lander reporting
editor_loadLoad HTML and settings for a variant

Mutations

ToolDescription
lander_publishPublish a landing page
lander_unpublishUnpublish a landing page
editor_saveSave HTML content for a variant
editor_save_settingsSave variant settings
variants_set_weightsSet A/B test traffic split
variants_enableEnable a variant
variants_disableDisable a variant
leads_updateUpdate a lead
leads_deleteDelete a lead
leads_update_orgUpdate a lead (org-level)
leads_delete_orgDelete a lead (org-level)
lander_integration_enableEnable an integration on a lander
lander_integration_disableDisable an integration on a lander
lander_integration_deleteRemove an integration from a lander
integration_createCreate an org-level integration
api_key_revokeRevoke an API key
api_key_updateUpdate an API key
Full schemas and parameters: API documentation

Authentication

The MCP server uses API key authentication. Pass your key in the X-API-Key header. The setup instructions above handle this automatically. Your key is tied to your organization. Every tool call uses it to identify your account and resolve permissions. No OAuth flow, no tokens to refresh. To revoke a key, go to Organization > API Keys in LanderLab or use the api_key_revoke tool.

Example Prompts

Once connected, just talk to your AI assistant in plain English:
“List all my landers and their status” Calls landers_list and returns page names, URLs, and publish status.
“Show me analytics for lander X over the last 7 days” Calls analytics_stats with the date range and returns visits, conversions, and leads.
“Unpublish lander X” Calls lander_unpublish to take the page offline.
“Set A/B test weights to 70/30 for lander X” Calls variants_set_weights to adjust traffic distribution between variants.
“Show me all leads from workspace 1” Calls leads_list and returns lead data for that workspace.

Troubleshooting

401 Unauthorized - The API key is missing, invalid, or revoked. Make sure the X-API-Key header is set and the key starts with ll_live_. Not Acceptable - The Accept header must include both application/json and text/event-stream. The setup instructions from this guide already set this. This error usually shows up when testing with curl or a custom client. FORBIDDEN: endpoint not accessible via API key - That specific tool has not been opened to API key auth yet. Contact LanderLab support for help. Server not showing up - Check that your config file is saved in the right location and the JSON is valid. Restart your AI tool after any config change.