Kwop › MCP server

Kwop MCP server

Kwop includes a remote MCP server. Paste one private link into Claude, ChatGPT, Cursor or Gemini, and your AI can read your visitors, their buying intent, your revenue and who to follow up, right inside the chat.

What the MCP server does

MCP (Model Context Protocol) is the open standard AI apps use to call outside tools. The Kwop MCP server exposes your Kwop data as 9 tools. Ask "who should I follow up today?" and your AI calls the right tool, gets the answer from your account and replies in plain words.

It reads the same data as your dashboard: every recorded visit (see session replay), funnels, traffic sources, buying-intent scores, and payments from your connected Stripe, Whop or Shopify account.

Endpoint and authentication

The server speaks MCP over Streamable HTTP: stateless JSON-RPC sent with POST. It supports protocol versions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05.

Your credential is a personal token, created the first time you open Kwop → MCP in the dashboard. That page shows Your MCP link, masked by default, with a button to reveal it and a Copy button. You can connect in two ways:

• Personal link (simplest): https://kwop.io/mcp/fl_…. The token is in the URL, so no header is needed. The setup steps in the dashboard use this link.
• Endpoint + header: https://kwop.io/mcp with Authorization: Bearer <token>. The token is the last part of your link, after /mcp/ (it starts with fl_).

Quick test from a terminal, listing the tools:

curl -X POST https://kwop.io/mcp \
  -H "Authorization: Bearer fl_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A wrong or old token returns 401 with "Invalid Kwop MCP link. Copy it again from Kwop → MCP." An account without Pro, or with a paused plan, returns 403.

The 9 tools

Every tool except list_sites takes an optional site (domain or id; defaults to your first site). Tools that cover a period take days (1 to 365, default 30); get_overview, list_visitors, who_to_follow_up and get_revenue also take minutes (1 to 1440) for short windows like "the last 2 hours".

Add Kwop to your AI app

The MCP page in your dashboard shows these steps with your link already filled in. Menu names belong to each app and can move.

Claude (claude.ai)

1. Open claude.ai → Settings → Connectors.
2. Click Add custom connector. Name: Kwop. URL: your MCP link.
3. In a chat, open the tools menu and turn on Kwop.

ChatGPT

1. Open ChatGPT → Settings → Apps & Connectors → Advanced and turn on Developer mode.
2. Click Create. Name: Kwop. MCP server URL: your MCP link. Authentication: none (the token is in the link).
3. In a chat, pick Kwop from the tools.

Claude Code

claude mcp add --transport http flow https://kwop.io/mcp/fl_YOUR_TOKEN

Cursor

Open Cursor Settings → MCP → Add new server and paste:

{
  "mcpServers": {
    "flow": { "url": "https://kwop.io/mcp/fl_YOUR_TOKEN" }
  }
}

Gemini CLI

Add this to ~/.gemini/settings.json:

{
  "mcpServers": {
    "flow": { "httpUrl": "https://kwop.io/mcp/fl_YOUR_TOKEN" }
  }
}

Other MCP clients

Any client that supports remote MCP servers over HTTP can connect. Use your personal link as the server URL, or https://kwop.io/mcp with the Authorization: Bearer header.

Example questions

• Who should I follow up today on Kwop?
• Where am I losing buyers this week?
• Write a follow-up email for my top 3 leads.
• Why do visitors leave my pricing page?
• Which plan converts best this month, and how much was left at checkout?
• What happened on my site in the last 2 hours?
• Did any price or promo code change recently?

Security

• Read-only tools. Every tool is marked read-only. Your AI reads data and drafts text; it cannot change your sites, settings or payments in Kwop. write_follow_up returns a draft and never sends it; Kwop only notes the draft in that visitor's follow-up history, so you can see later if they came back or paid.
• Private link. Anyone with your MCP link can read your Kwop data. Treat it like a password.
• Regenerate anytime. Regenerate link on the MCP page creates a new token. The old link stops working right away; paste the new one in your AI apps.
• Scoped to your account. A token only opens the sites of the Kwop account it belongs to, and returns the same data your dashboard shows.

Plan

The MCP server is part of Kwop Pro: $119/month at launch price, then $238/month, with 20% off on yearly billing. Pro also includes unlimited sites, every session recorded, the Stripe, Whop and Shopify connectors, revenue tracking, Kwop and real-time hot-lead alerts. Starter does not include the MCP. If a Pro payment fails and is not fixed within 2 days, the MCP pauses until the plan is renewed.