MCP Server

The GrowPanel MCP Server lets AI assistants like Claude, Cursor, and other MCP-compatible tools access your subscription analytics through natural language.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants to securely connect to external data sources. With the GrowPanel MCP Server, you can ask questions like "What's my current MRR?" or "Show me churn for the last quarter" directly in your AI assistant.

Installation

Prerequisites

• Node.js 18 or later (the server uses the global fetch API)
• A GrowPanel account with API access
• An MCP-compatible AI client (Claude Desktop, Cursor, etc.)

Step 1: Install the server

Install the MCP server globally via npm:

npm install -g growpanel-mcp-server

Step 2: Set your API token

Export your GrowPanel API token as an environment variable:

export GROWPANEL_API_TOKEN=sk_live_xxx

You can find your API token in GrowPanel under Settings > API Keys. See Authentication for details on creating API keys.

Step 3: Start the server

Run the MCP server:

growpanel-mcp

The server starts on http://localhost:3000/mcp by default.

Step 4: Connect your AI client

Configure your MCP client to connect to the server endpoint:

http://localhost:3000/mcp

Refer to your AI client's documentation for specific setup instructions.

Available tools

The MCP server exposes three tools that your AI assistant can use:

getMRR

Returns your key revenue metrics:

• MRR - Monthly Recurring Revenue
• ARR - Annual Recurring Revenue
• ARPA - Average Revenue Per Account
• ASP - Average Selling Price
• Churn metrics - Revenue churn rate, logo churn rate
• LTV - Customer Lifetime Value

getLeads

Returns lead and trial funnel metrics:

• Leads - Total leads in period
• Trials - Active trials
• Trial conversion - Percentage of trials converting to paid

getCohorts

Returns cohort analysis data for understanding retention patterns over time.

Filtering data

All tools support the same query parameters as the GrowPanel API. Pass filters to narrow down your results:

Example queries you might ask your AI assistant:

• "What was my MRR in Q1 2024?"
• "Show me churn metrics for the US region"
• "Get cohort retention for customers on the Pro plan"

How it works

The MCP server runs locally on your machine and acts as a bridge between your AI assistant and the GrowPanel API:

1. Your AI assistant sends a natural language query
2. The MCP server translates this into the appropriate API call
3. The server authenticates using your Bearer token
4. Data is fetched from https://api.growpanel.io
5. Results are returned to your AI assistant in a structured format

Because the server runs locally, your API token never leaves your machine.

Example usage

Once connected, you can ask your AI assistant questions like:

Revenue questions:

• "What's my current MRR?"
• "How has ARR changed over the last 6 months?"
• "What's my average revenue per account?"

Churn questions:

• "What's my churn rate this month?"
• "Show me LTV trends"

Funnel questions:

• "How many trials converted last month?"
• "What's my trial-to-paid conversion rate?"

Cohort questions:

• "Show me retention by signup cohort"
• "How does the January cohort compare to February?"

Troubleshooting

Server won't start

Ensure you have Node.js 18 or later:

node --version

Authentication errors

Verify your API token is set correctly:

echo $GROWPANEL_API_TOKEN

The token should start with sk_live_ or sk_test_.

Connection refused

Make sure the server is running and your MCP client is configured to connect to http://localhost:3000/mcp.

Security considerations

• The MCP server runs locally and only communicates with https://api.growpanel.io
• Your API token is stored in your local environment, not transmitted to third parties
• Use a read-only API key if you only need to query data
• Rotate your API key periodically for security

Need help?

• Check the API documentation for details on available data
• Review Authentication for API key setup
• Contact support at [email protected]