Documentation Setup (Unify) Configure ThriveStack MCP Server
ThriveStack MCP

Configure ThriveStack MCP Server

The ThriveStack Model Context Protocol (MCP) server enables AI tools to query and create ThriveStack artifacts (signals, charts, dashboards, experiments, cohorts) via conversational UI.

The Thrivestack MCP on GitHub. MCP integration guides and examples are available in Anthropic Claude documentation, the MCP quickstart resources, and Cursor's MCP documentation.

Remote server

  • Available to existing ThriveStack customers.
  • You must use a code editor or application that supports MCP servers (for example, Cursor, Claude Code, ChatGPT, Lovable, or Gemini CLI).
  • Configure ThriveStack MCP server URL: https://api.app.thrivestack.ai/mcp. Authenticate with x-api-key for any MCP client (sample demo x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=). OAuth-style authorization is available for Claude and Claude Desktop only.

Quick Connect

Endpoint Configure ThriveStack MCP Server
Primary endpoint https://api.app.thrivestack.ai/mcp

Available tools and capabilities

This section shows what the ThriveStack MCP can do through example prompts—correlated journeys (Marketing / Product / Revenue) and tool-oriented examples (grouped reference prompts)—not a raw tool catalog. Expand each accordion to reuse these patterns in your AI client after the server is connected.

Marketing

Signup & journey drill-downs

Tool name Example prompt
Recent signup days & paths
“Show me which days people signed up recently, then let me pick a day and see who those users are, then let me pick someone and walk through their path before they signed up.”
Busy day → users → pre-signup path
“For our last busy signup day, list the users who came in that day and let me drill into one person’s pre-signup visits and campaigns.”

Conversion & touchpoints

Tool name Example prompt
Time & touchpoints to signup
“Summarize how long it usually takes people to sign up and how many touchpoints they have before converting.”
Conversion reporting window
“Pull up our conversion analytics for the current reporting window and highlight anything that looks off.”
Product

Activation & portfolio risk

Tool name Example prompt
Activation milestones
“List our activation modules and milestones, then let me pick a milestone and show which accounts made it through versus which dropped off.”
Stickiness & churn portfolio
“Give me a portfolio view of churn and expansion risk: stickiness buckets and how inactive accounts have trended.”

Account engagement & journeys

Tool name Example prompt
Full account engagement profile
“For this account, show me a full engagement profile—health, subscription, acquisition, and users—and flag if we should intervene.”
User journey (sessions & pages)
“After you show that account profile, if there’s a main user to follow, show their pre-signup journey with sessions and pages in order.”
Revenue

Campaigns & revenue drill-downs

Tool name Example prompt
Campaign revenue ranking
“Rank campaigns by revenue, show totals, then let me pick one campaign and list the customers and how much each paid.”
Revenue by source (channel)
“Show revenue by source within each channel, ranked, then let me pick one row and break out the customers behind it.”

Channels & paying customers

Tool name Example prompt
Channel share & LTV view
“Show channel-level revenue, share, and a simple LTV-style view, then let me pick a channel and split out top campaigns, sources, and customers.”
Top channel & campaign customers
“Which channel and campaign drove the most revenue this period? Then show me the paying customers for that campaign.”
Other MCP tools reference prompts

Example questions for each tool name, unlike the correlated sections above, these do not require a multi-step drill-down.

Core analytics

Tool name Example prompt
MAU & MTU Count
“What were our MAU and MTU for March 2026?”
Event Count
“How many events did we record in the last 30 days?”

Accounts

Tool name Example prompt
List Accounts
“List our first 20 accounts sorted by last active time, newest first.”

GTM

Tool name Example prompt
PLG-Qualified Leads
“Show PLG-qualified leads for identify leads, page 1, 50 per page.”

Setup

Tool name Example prompt
Get Setup Status
“Is our ThriveStack setup finished, and what’s still pending?”
Start ThriveStack Telemetry Setup
“I want product telemetry only—here’s my API key: <paste key>.”

Traffic & marketing surface

Tool name Example prompt
Visitors (monthly)
“How many visitors did we get this month (monthly view)?”
Page Views (monthly)
“What’s our page view count for the monthly template?”
Unique Visitors (monthly)
“How many unique visitors this month?”
Signups (monthly/value/delta)
“How many signups did we get—show value, delta, and monthly breakdown.”

Acquisition quality

Tool name Example prompt
Abuse Detection (monthly/value/delta)
“How many abuse cases were flagged—monthly and delta if you have it.”
Acquisition Accounts (monthly/value/delta)
“How many acquisition accounts are we seeing?”
Total Acquisition Accounts (monthly/value/delta)
“What’s our total acquisition accounts metric across value, delta, daily, and monthly?”
Touchpoints to Acquisition (monthly/value/delta)
“What’s the touchpoints-to-acquisition number?”
Time to Acquisition (monthly/value/delta)
“What’s our time-to-acquisition metric?”
Acq Conversion (monthly/value/delta)
“What’s our acquisition conversion rate?”
Avg Time to First Value (monthly)
“What’s the average time to first value?”

Activation & accounts

Tool name Example prompt
Users Activated This Month (monthly)
“How many users activated this month?”
Activation Rate (monthly)
“What’s our activation rate?”
Total Accounts Activated (monthly)
“How many accounts are activated (monthly view)?”
Total Accounts (monthly)
“How many total accounts do we have—value and monthly?”

Revenue & monetization (module metrics)

Tool name Example prompt
New Payers (monthly/value/delta)
“How many new payers did we add?”
Net New MRR (monthly/value/delta)
“What’s net new MRR?”
Gross MRR Added (monthly/value/delta)
“How much gross MRR did we add?”
Total Company MRR (monthly)
“What’s total company MRR—value and monthly trend?”
Avg Time from Acq to Conv (monthly)
“What’s the average time from acquisition to conversion?”
Avg Time from Act to Conv (monthly)
“What’s the average time from activation to conversion?”

Usage & engagement

Tool name Example prompt
Daily Active Users (monthly/value)
“What are daily active users?”
Weekly Active Users (value/delta/monthly)
“What are weekly active users—value, delta, and monthly?”
Monthly Active Users (monthly/value)
“What are monthly active users?”
Monthly Active Accounts (value/delta/monthly)
“How many monthly active accounts?”
Low Stickiness (value/delta/monthly)
“How many low-stickiness accounts?”
Medium Stickiness (value/delta/monthly)
“How many medium-stickiness accounts?”
High Stickiness (value/delta/monthly)
“How many high-stickiness accounts?”
Adoption Rate (value/delta/monthly)
“What’s our adoption rate?”

Implementation instructions

Configure your MCP client to connect to https://api.app.thrivestack.ai/mcp. x-api-key authentication works across MCP clients (ThriveStack Dashboard -> Settings -> API Keys). Claude and Claude Desktop can also authenticate via their OAuth-style authorization flow when prompted.

Note: Get an API key from Settings → API Keys. The x-api-key shown in examples on this page is a sample x-api-key for demos.
Claude Desktop

For general MCP connector setup, refer to Claude Desktop MCP servers documentation.

  1. Navigate to claude.ai (or open the Claude desktop app).
  2. Go to Settings > Connectors > Add custom connector.
  3. Configure the connector:
    • Name: Thrivestack
    • URL: https://api.app.thrivestack.ai/mcp
  4. Complete the ThriveStack OAuth-style authorization flow when prompted.
  5. Start asking questions; ThriveStack tools will be available in MCP mode.

Alternatively: add this to ~/Library/Application Support/Claude/claude_desktop_config.json using this demo x-api-key:

JSON
{
  "mcpServers": {
    "thrivestack": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.app.thrivestack.ai/mcp",
        "--header",
        "x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g="
      ]
    }
  }
}
Claude Code CLI

For general MCP setup, refer to Claude Code MCP documentation.

  1. Add the ThriveStack MCP server globally:
    Shell
    claude mcp add -t http -s user Thrivestack "https://api.app.thrivestack.ai/mcp"

    OR: use x-api-key authentication (demo x-api-key shown, works with any MCP client):

    Shell
    claude mcp add -t http -s user Thrivestack "https://api.app.thrivestack.ai/mcp" --header "x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g="
  2. Start Claude Code:
    Shell
    claude
  3. Enter MCP mode:
    Shell
    /mcp
  4. When prompted, complete ThriveStack OAuth-style authorization.
Cursor / Windsurf

Use this sample demo x-api-key via the x-api-key header: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=. For general MCP setup, refer to Cursor's MCP documentation.

  1. Open Cursor Settings.
  2. Go to Tools & Integrations > New MCP Server.
  3. Add the ThriveStack MCP configuration using this demo x-api-key:
    JSON
    {
  "mcpServers": {
    "thrivestack": {
      "url": "https://api.app.thrivestack.ai/mcp",
      "headers": {
        "x-api-key": "d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g="
      }
    }
  }
}
  4. Complete the ThriveStack authentication flow (x-api-key, sample demo x-api-key shown above) when prompted.
Gemini CLI

For general MCP setup, refer to Gemini CLI MCP server documentation.

  1. Ensure you're authenticated with Gemini.
  2. Add this to your ~/.gemini/settings.json using this demo x-api-key:
    JSON
    {
  "mcpServers": {
    "thrivestack": {
      "httpUrl": "https://api.app.thrivestack.ai/mcp",
      "headers": {
        "x-api-key": "d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g="
      }
    }
  }
}
  3. Restart Gemini CLI to load the MCP server.
  4. Start asking questions; ThriveStack tools will be available in MCP mode.
Lovable Coming soon

For MCP connector setup, refer to Lovable's MCP servers documentation. ThriveStack supports x-api-key (use sample demo x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=).

  1. Log in to Lovable.
  2. Open Settings, then go to Connectors.
  3. Add a new MCP connector (or search for Thrivestack if available).
  4. Configure the connector:
    • URL: https://api.app.thrivestack.ai/mcp
    • Auth header: x-api-key = d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g= (sample demo x-api-key)
  5. Complete the ThriveStack connection flow in Lovable.
Other MCP clients

For MCP-compatible clients not listed above, configure the client to connect to https://api.app.thrivestack.ai/mcp and provide this sample demo x-api-key as an x-api-key header: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=.

  1. Configure your client's MCP server URL to https://api.app.thrivestack.ai/mcp.
  2. Ensure your client supports custom HTTP headers and set x-api-key to d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g= (sample demo key).
  3. Authenticate/connect when prompted (if your client asks for it).
  4. Start using ThriveStack tools in MCP mode.

Plugins (coming soon)

ThriveStack plans to publish an MCP marketplace to extend MCP with reusable analysis and instrumentation skills. Until released, connect directly to the ThriveStack MCP server URL and use the built-in tools it exposes.

Troubleshooting

  • Authentication problems: confirm you completed the ThriveStack auth flow and re-authenticate if tokens expire.
  • Missing data: ensure your ThriveStack account has access to the target project and artifact exists.
  • Tool not found: tool availability depends on what your MCP server exposes for your account.
  • Queries timing out: try smaller questions or narrower date ranges.

Technical specifications

  • Transport Type: Streaming HTTP (Remote)
  • Authentication: x-api-key header (sample/demo x-api-key format shown on this page) and OAuth 2.1 (Claude and Claude Desktop)
Previous Events Telemetry Next Vibe Analytics (AI)