GenConvert MCP Server

Getting Started

The GenConvert MCP server exposes the same account, websites, campaigns, forms, team, webhooks, analytics, invoices, and plan data as the REST API — but as MCP tools an AI agent can call directly, instead of you writing HTTP requests by hand.

Endpoint:

https://genconvert.com/api/panel/mcp

It speaks Streamable HTTP (JSON-RPC 2.0) per the Model Context Protocol spec. Most MCP client apps handle the handshake for you — you only need to give them the URL and an Authorization header (see below). If you're building or debugging a client by hand, point the @modelcontextprotocol/inspector CLI at the endpoint instead of crafting raw requests.

Authentication

There are two ways to authenticate. Most people should use sign-in (OAuth).

Sign in with your browser (OAuth) — recommended

Give your AI client just the endpoint URL. It opens a GenConvert page in your browser, you sign in and click Allow access, and the client is connected — no API key to create, copy, or rotate.

• You choose what it may do: Read and change or Read only. A read-only connection can call only the get_* and list_* tools; every other tool answers that the connection is read-only. A client that asks for the read scope only is given read-only.
• The client registers itself automatically (OAuth 2.1 with PKCE and dynamic client registration), so there is nothing to configure on the GenConvert side.
• Access tokens last one hour and are renewed automatically. A connection ends 90 days after you approved it, or after 30 days without use, or when you disconnect it or change your password; approve it again to carry on.
• See and disconnect connected clients under Dashboard → Profile → Connected Apps. Disconnecting takes effect immediately.
• A connection is tied to one server: a token for /api/panel/mcp can't be used anywhere else, including the REST API.

Clients that need the raw discovery documents can find them at /.well-known/oauth-protected-resource/api/panel/mcp and /.well-known/oauth-authorization-server.

API key — for scripts and headless environments

Same API key as the REST API, sent as a bearer token:

Authorization: Bearer gc_live_xxxxxxxxxxxxxxxxxxxxxxxx

• Create and revoke keys from Dashboard → Profile → API Keys.
• The full key is shown exactly once, right after you create it — copy it then.
• A key is read only or full access, chosen when you create it. With a read-only key the get_* tools work and every other tool answers that the key is read-only. A full-access key has the permissions of the account that created it.
• Revoking a key takes effect immediately, for both the REST API and MCP. Every key is also revoked when the account's password is reset or changed, or when you sign out everywhere.
• A key that has not been used for 90 days stops working, for both the REST API and MCP. It stays in your key list, marked as expired, and you can revoke it. A key you use regularly never expires.

Connecting a Client

With sign-in (recommended)

Claude Code — add the server, then run /mcp, choose genconvert and select Authenticate. Your browser opens so you can approve access:

claude mcp add --transport http genconvert https://genconvert.com/api/panel/mcp

Claude, Cursor, VS Code and other clients with a "remote MCP server" or "custom connector" option — paste the endpoint URL below and leave any API key or header fields empty. The client starts the sign-in on its own:

https://genconvert.com/api/panel/mcp

With an API key

Paste your API key in the bar above and the snippets below will include it — otherwise they show a placeholder for you to fill in.

Claude Code

Add it as a remote HTTP server:

claude mcp add --transport http genconvert https://genconvert.com/api/panel/mcp \
  --header "Authorization: Bearer gc_live_xxxxxxxxxxxxxxxxxxxxxxxx"

Claude Desktop, Cursor, and other MCP clients

Most desktop MCP clients accept a remote server as a URL plus custom headers, either in their settings UI or in an mcp.json-style config file:

{
  "mcpServers": {
    "genconvert": {
      "url": "https://genconvert.com/api/panel/mcp",
      "headers": {
        "Authorization": "Bearer gc_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

The exact config file name/location and whether custom headers are supported varies by client — check that client's own MCP documentation if this doesn't work out of the box.

Rate Limits

Requests are limited to 300 requests per minute per account — the same ceiling as the REST API, sized for an agentic loop rather than a single click. Going over returns a 429 Too Many Requests HTTP response with a Retry-After header.

Errors

Two layers of errors can happen:

• Transport-level — a missing, invalid, expired, or revoked credential returns an HTTP 401 before any tool runs. The response includes a WWW-Authenticate header pointing at the OAuth discovery document, which is how OAuth-capable clients know to start the sign-in.
• Tool-level — a tool call that fails (not found, validation error, insufficient permissions) still returns HTTP 200, with the tool result's isError set to true and a human-readable message in content[0].text, e.g. "Website or insufficient permissions". Check isError, not the HTTP status, to detect a failed tool call.

WebMCP for Visitors

Separate from the MCP server above (which needs a merchant account), the public pages — the landing page, docs, blog, contact, and company pages — register WebMCP tools via document.modelContext for AI agents built into the browser. No signup or key: an agent helping an anonymous visitor can read pricing, FAQs, integrations, features, and blog posts, subscribe them to the newsletter or send a contact message (with consent), and navigate the tab — all in the live page the visitor already has open.

• Ephemeral: tools exist only while the tab is open — there is no endpoint to call headlessly. For background or account work, use the MCP server instead.
• Browser support: draft web standard, available in Chromium 146+ behind the WebMCP flag (149+ origin trial). Other browsers silently get no tools; the site works unchanged for humans.
• Tools: get_pricing_plans, get_product_faq, get_integrations, get_product_features, search_blog, subscribe_newsletter, navigate_to, contact_sales, get_changelog, search_docs, estimate_roi (illustrative estimator, not a guarantee). Only the newsletter and contact writes are non-readonly, and both reuse the existing rate-limited public endpoints.
• Declarative forms: the contact page and the footer newsletter signup additionally declare their tools in plain HTML (toolname / tooldescription attributes), so fill_contact_form and fill_newsletter_form can fill the fields for the visitor to review — nothing is sent without their own click on Send or Subscribe.

Account

Read and update the authenticated merchant's own profile and stats.

{ "name": "get_user_profile_and_stats" }

{
  "name": "update_profile_name",
  "arguments": { "name": "Jane Doe" }
}

{ "name": "get_user_stats" }

Websites

Create and manage the websites (storefronts) connected to the account.

{ "name": "get_websites" }

{
  "name": "create_website",
  "arguments": { "domain": "example.com", "websiteName": "My Store" }
}

{
  "name": "get_website",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "update_website",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "data": {}
  }
}

{
  "name": "delete_website",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "toggle_website_enable",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "get_website_dashboard_stats",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

Campaigns

Create and manage AI popup campaigns within a website.

{
  "name": "get_website_campaigns",
  "arguments": { "id": "65f1a2b3c4d5e6f7a8b9c0d1", "pagination": { "page": 1, "page_size": 20 } }
}

{
  "name": "create_website_campaign",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "data": {
      "name": "Spring Sale Popup",
      "prefrence": { "brand_tone": ["friendly", "urgent"], "userPrompt": "Promote our 20% spring sale" },
      "devices": { "mac": true, "pc": true, "ios": true, "android": true },
      "triggers": { "delay": 10, "scrollDepth": 0, "exitIntent": true, "inactivity": 0 }
    }
  }
}

{
  "name": "get_website_campaign",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "campId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "update_website_campaign",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "campId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "data": {}
  }
}

{
  "name": "delete_website_campaign",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "campId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "update_campaign_popup_design",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "campId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "design": {}
  }
}

Forms & Popups

Read lead-capture forms, their submissions, and generated popups.

{
  "name": "get_website_campforms",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "get_website_form_submissions",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "pagination": {
      "page": 1,
      "page_size": 20
    }
  }
}

{
  "name": "get_website_popups",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "pagination": {
      "page": 1,
      "page_size": 20
    }
  }
}

Team

Manage a website's team members and their roles.

{
  "name": "invite_website_team_member",
  "arguments": { "id": "65f1a2b3c4d5e6f7a8b9c0d1", "email": "teammate@example.com", "role": "editor" }
}

{
  "name": "update_team_member_role",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "memberId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "role": "owner"
  }
}

{
  "name": "remove_team_member",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "memberId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

Webhooks

Create, test, and monitor webhook endpoints that receive account events.

{
  "name": "get_website_webhooks",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "create_website_webhook",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "data": {
      "url": "https://hooks.zapier.com/hooks/catch/xxxxx/yyyyy/",
      "events": ["form.submitted", "newsletter.submitted"],
      "active": true
    }
  }
}

{
  "name": "update_website_webhook",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "data": {}
  }
}

{
  "name": "delete_website_webhook",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "regenerate_website_webhook_secret",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "get_website_webhook_deliveries",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "pagination": {
      "page": 1,
      "page_size": 20
    }
  }
}

{
  "name": "retry_website_webhook_delivery",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "deliveryId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "send_test_website_webhook_event",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "webhookId": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

Analytics

Pull TimescaleDB-backed analytics for a website: time series, funnels, heatmaps, segments, and AI-cache ROI.

{
  "name": "get_website_analytics_chart",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "startDate": "2026-08-01",
    "endDate": "2026-08-31"
  }
}

{
  "name": "get_website_analytics_funnel",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "startDate": "...",
    "endDate": "..."
  }
}

{
  "name": "get_website_analytics_heatmap",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "startDate": "...",
    "endDate": "..."
  }
}

{
  "name": "get_website_analytics_segments",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "startDate": "...",
    "endDate": "..."
  }
}

{
  "name": "get_website_analytics_cache_roi",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "startDate": "...",
    "endDate": "..."
  }
}

Support Tickets

File and follow up on support tickets without leaving your AI client.

{
  "name": "get_tickets",
  "arguments": {
    "pagination": {
      "page": 1,
      "page_size": 20
    }
  }
}

{
  "name": "create_ticket",
  "arguments": { "subject": "Webhook not firing", "priority": "high", "posts": "My Zapier webhook stopped receiving events after rotating the secret." }
}

{
  "name": "get_ticket",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

{
  "name": "add_ticket_post",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "content": "..."
  }
}

Invoices

Read the account's billing history.

{
  "name": "get_invoices",
  "arguments": {
    "pagination": {
      "page": 1,
      "page_size": 20
    }
  }
}

{
  "name": "get_invoice",
  "arguments": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1"
  }
}

Plans

Read plan history and current usage against plan limits.

{ "name": "get_plan_history" }

{ "name": "get_plan_stats" }