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 withx-api-keyfor 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
The ThriveStack MCP provides comprehensive access to your analytics through these tools:
Available tools
| Tool Name | Description |
|---|---|
Company Name from Contacts
|
Resolve a company name from your contacts information. |
Event Count
|
Get event totals to summarize usage activity. |
MAU & MTU Count
|
Return Monthly Active Users (MAU) and Monthly Tracked Users (MTU). |
PLG-Qualified Leads
|
List PLG-qualified leads that are ready for sales follow-up. |
Get Setup Status
|
Check whether ThriveStack telemetry setup is complete and connected. |
List Accounts
|
List accounts with the metrics needed for PLG analytics. |
Start ThriveStack Telemetry Setup
|
Start the telemetry setup workflow so your instance can generate data. |
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.
- Navigate to claude.ai (or open the Claude desktop app).
- Go to Settings > Connectors > Add custom connector.
-
Configure the connector:
- Name: Thrivestack
- URL:
https://api.app.thrivestack.ai/mcp
- Complete the ThriveStack OAuth-style authorization flow when prompted.
- 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:
{
"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.
-
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-keyauthentication (demo x-api-key shown, works with any MCP client):Shellclaude mcp add -t http -s user Thrivestack "https://api.app.thrivestack.ai/mcp" --header "x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=" -
Start Claude Code:
Shell
claude -
Enter MCP mode:
Shell
/mcp - 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.
- Open Cursor Settings.
- Go to Tools & Integrations > New MCP Server.
-
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=" } } } } -
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.
- Ensure you're authenticated with Gemini.
-
Add this to your
~/.gemini/settings.jsonusing this demo x-api-key:JSON{ "mcpServers": { "thrivestack": { "httpUrl": "https://api.app.thrivestack.ai/mcp", "headers": { "x-api-key": "d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=" } } } } - Restart Gemini CLI to load the MCP server.
- 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=).
- Log in to Lovable.
- Open Settings, then go to Connectors.
- Add a new MCP connector (or search for Thrivestack if available).
-
Configure the connector:
-
URL:
https://api.app.thrivestack.ai/mcp -
Auth header:
x-api-key=d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=(sample demo x-api-key)
-
URL:
- 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=.
-
Configure your client's MCP server URL to
https://api.app.thrivestack.ai/mcp. -
Ensure your client supports custom HTTP headers and set
x-api-keytod8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g=(sample demo key). - Authenticate/connect when prompted (if your client asks for it).
- Start using ThriveStack tools in MCP mode.
Query examples
Accounts
List Accounts
“Who are my top 10 accounts by engagement this month?”
“List accounts that have been active in the last 30 days, sorted by last active time.”
“Show me the first 20 accounts, sorted by health score descending.”
Company Name from Contacts
“Given contacts with domain = thrivestack.ai, what company name do you infer?”
“Find the company name for contacts where email eq engineerpersona@thrivestack.ai.”
“Derive company name from contacts in country eq United States and industry eq SaaS.”
Analytics
MAU & MTU Count
“What are my MAU and MTU for 2026-03?”
“Give me MAU vs MTU for 2026-01.”
“For last month (2026-02), what were MAU and MTU?”
Event Count
“How many events did we track in 2026-03?”
“What’s the total event count for last_30_days?”
“Show event volume for last_7_days.”
GTM
PLG-Qualified Leads
“Show me PLG leads ready for sales outreach (type identify), first page.”
“Get PLG leads of type group, page 2, 25 per page.”
“Pull the newest 50 PLG-qualified leads (type identify).”
Setup
Start ThriveStack Telemetry Setup
“Help me set up ThriveStack for marketing telemetry. Here’s my x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g= (sample demo x-api-key).”
“I need product instrumentation; use this ThriveStack API x-api-key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g= (sample demo key).”
“Set up both marketing + product telemetry. API key: d8rRhN6Ji8BGZdlVJONMm/e06k1zLkT4pHoN4LstE4g= (sample demo key).”
Get Setup Status
“What’s my setup completion status right now?”
“Which setup steps are still pending for my environment?”
“Show warnings/blockers in my onboarding/setup progress.”
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-keyheader (sample/demo x-api-key format shown on this page) and OAuth 2.1 (Claude and Claude Desktop)