Connect the RocketPages MCP server to your preferred AI client. Choose your tool below and follow the configuration steps.

Claude Code

Add to your project's .mcp.json file:

{
  "mcpServers": {
    "rocketpages": {
      "type": "http",
      "url": "https://api.rocketpages.io/mcp"
    }
  }
}

Or use the CLI:

claude mcp add --transport http rocketpages https://api.rocketpages.io/mcp

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.rocketpages]
url = "https://api.rocketpages.io/mcp"

Or use the CLI:

codex mcp add rocketpages --url https://api.rocketpages.io/mcp

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "rocketpages": {
      "url": "https://api.rocketpages.io/mcp"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "rocketpages": {
      "serverUrl": "https://api.rocketpages.io/mcp"
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your project root (requires VS Code 1.101+):

{
  "servers": {
    "rocketpages": {
      "type": "http",
      "url": "https://api.rocketpages.io/mcp"
    }
  }
}

Claude Desktop

Open Settings → Connectors → Add custom connector and enter the MCP server URL: https://api.rocketpages.io/mcp

Or add to claude_desktop_config.json:

{
  "mcpServers": {
    "rocketpages": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.rocketpages.io/mcp"]
    }
  }
}

ChatGPT

Open Settings → Apps & Connectors → Create and enter the MCP server URL: https://api.rocketpages.io/mcp. Save the connector and attach it in any new chat. Requires a paid ChatGPT plan.

First-Time Connection

When your client connects for the first time:

• A browser window opens for authentication.
• Sign in with your RocketPages account.
• Approve the requested permissions.
• Your client receives tokens automatically and is ready to use.

Step 1 — Connect Your MCP Client

Add the RocketPages MCP server to your client configuration (see Setup & Configuration above).

When your client connects for the first time:

• A browser window opens for authentication.
• Sign in with your RocketPages account.
• Approve the requested permissions.

Step 2 — List Your Websites

Ask your AI client:

List all my websites

The MCP server calls list_websites and returns website IDs, names, subdomains, and publish status.

Or call the REST API directly:

curl -H "Authorization: Bearer rp_key_<your_api_key>" https://api.rocketpages.io/api/configs/users-site-configs

If you don't have any websites yet, continue to Step 3.

Step 3 — Create a Website

Ask your AI client:

Create a new website called "My Portfolio"

The MCP server calls create_website, guides you through a questionnaire, and returns your site_id, site name, subdomain, and editor URL.

Your website is created with a default homepage.

Step 4 — Browse Templates (Optional)

Ask your AI client:

Show me available templates in the Portfolio category

The MCP server calls list_templates and returns available templates across multiple categories.

You can create a website from a template instead of starting from scratch.

Step 5 — Add Content Sections

Ask your AI client:

Add a welcome section with the title "Welcome to My Portfolio" and a services section with 3 cards for Web Design, Development, and Branding

The MCP server calls add_section for each requested section.

To explore available layouts first, ask:

Show me available layouts for welcome sections

The MCP server calls list_layouts and returns supported layout variations.

Step 6 — Customize Styling

Ask your AI client:

Show me available color palettes and apply one with blue tones. Also show me font pairings.

The MCP server calls list_color_palettes and list_font_pairings.

Apply any palette or font combination using update_website.

Or via REST API:

GET /api/configs/color-palettes
GET /api/configs/font-pairings

Step 7 — Publish Your Site

Ask your AI client:

Publish my website and show me the live URL

The MCP server calls publish_website and returns your live URL.

Your website is now live.

Step 8 — Add a Custom Domain (Optional)

Ask your AI client:

Add the custom domain example.com to my site

The MCP server calls add_custom_domain and provides the DNS records required for configuration.

After updating DNS records, verify the setup:

Validate my custom domain

The MCP server calls validate_custom_domain.

To monitor SSL certificate provisioning:

Check SSL status for my custom domain

The MCP server calls check_ssl_status.

What's Next?

You can now:

• Explore the full tools reference for all 71 MCP tools.
• Use the REST API to build custom integrations and dashboards.
• Create websites from templates.
• Customize layouts, styling, and content.
• Connect custom domains.
• Build automations using the REST API with your API key.

MCP Protocol (JSON-RPC)

Base URL: https://api.rocketpages.io/mcp

All MCP tool calls are sent to this single endpoint using JSON-RPC 2.0 over HTTP with Server-Sent Events (SSE) for streaming. Authentication is handled automatically by your MCP client.

REST API (Direct HTTP)

Every MCP tool is also accessible as a standard REST API endpoint. Use a permanent API key for authentication. No MCP protocol or JSON-RPC required.

Base URL: https://api.rocketpages.io/api

Headers:

Content-Type: application/json
Authorization: Bearer rp_key_<your_api_key>

REST API Example: List Websites

GET /api/configs/users-site-configs

Response:
{
  "data": [
    {
      "siteId": "abc123",
      "siteName": "My Business",
      "isPublished": true,
      "subDomain": "my-business"
    }
  ]
}

REST API Example: Get Site Config

GET /api/configs/site-config?siteId=abc123

Response:
{
  "data": {
    "siteId": "abc123",
    "siteName": "My Business",
    "isPublished": true,
    "subDomain": "my-business",
    "header": { ... },
    "footer": [ ... ],
    "palette": { ... }
  }
}

REST API Example: Update Site

POST /api/configs/append-site-config
Content-Type: application/json

{
  "siteId": "abc123",
  "siteName": "Updated Name"
}

MCP vs REST API

• MCP tools — designed for AI assistants. One tool call can orchestrate multiple API calls, handle validation, generate content, and return formatted results.
• REST API — designed for developers and integrations. Direct HTTP access to individual operations. You handle orchestration.

Both access the same underlying service layer.

MCP Sample Request: list_websites

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_websites",
    "arguments": {}
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": {
          "websites": [
            {
              "site_id": "2e2b85c5-...",
              "site_name": "My Site",
              "sub_domain": "mysite",
              "is_published": true,
              "site_url": "mysite.rocketpagesweb.com"
            }
          ]
        }
      }
    ]
  }
}

MCP Sample Request: create_website

Request:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_website",
    "arguments": {
      "site_name": "My Portfolio",
      "sub_domain": "myportfolio"
    }
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": {
          "success": true,
          "site_id": "a1b2c3d4-...",
          "site_name": "My Portfolio",
          "sub_domain": "myportfolio",
          "editor_url": "https://editor.rocketpages.io/a1b2c3d4-..."
        }
      }
    ]
  }
}

MCP Sample Request: add_section

Request:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "add_section",
    "arguments": {
      "site_id": "a1b2c3d4-...",
      "page_id": "f7g8h9i0-...",
      "section_type": "welcome",
      "layout": "welcome_v1",
      "title": "Hello World",
      "description": "Welcome to my site"
    }
  }
}

Response:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": {
          "success": true,
          "section_index": 0,
          "section_type": "welcome",
          "layout": "welcome_v1"
        }
      }
    ]
  }
}