growpanel-mcp-server by growpanel - MCP Server

GrowPanel MCP Server

MCP server for GrowPanel subscription analytics. Connects AI assistants (Claude, Cursor, Windsurf, etc.) to your GrowPanel data via the Model Context Protocol.

14 tools covering reports, customers, plans, settings, webhooks, billing, team, and more. Plus a generic API passthrough that automatically supports new API features.

Installation

npm install -g growpanel-mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
    "mcpServers": {
        "growpanel": {
            "command": "growpanel-mcp",
            "env": {
                "GROWPANEL_API_KEY": "your-api-key-here"
            }
        }
    }
}

Cursor / Other MCP Clients

Most MCP clients support a similar configuration. Set the command to growpanel-mcp and provide the GROWPANEL_API_KEY environment variable.

Environment Variables

Variable	Description	Default
`GROWPANEL_API_KEY`	Your GrowPanel API key (required)	—
`GROWPANEL_API_URL`	API base URL	`https://api.growpanel.io`

For backward compatibility, GROWPANEL_API_TOKEN is also accepted.

Get your API key at app.growpanel.io → Settings → API Keys.

Available Tools

Analytics

Tool	Description
`get_report`	Fetch any analytics report by name (mrr, summary, cohort, leads, cashflow, etc.)

The get_report tool accepts any report name — new reports added to the API work automatically.

Known reports: mrr, mrr-table, summary, cmrr-summary, movement-table, map, cohort, leads, leads-table, leads-days, leads-summary, transactions, transactions-table, transactions-detail, transactions-summary, invoices-detail, churn-scheduled, churn-scheduled-movements, churn-scheduled-summary, customer-concentration, cashflow-failed-payments, cashflow-failed-payments-summary, cashflow-refunds, cashflow-refunds-table, cashflow-failure-rate, cashflow-outstanding-unpaid, custom-variables

Customers & Plans

Tool	Description
`list_customers`	List customers with MRR and subscription details
`get_customer`	Get detailed info for a specific customer
`resync_customer`	Trigger a data resync from the payment provider
`list_plans`	List all subscription plans and plan groups

Data Management

Tool	Description
`manage_data`	CRUD operations on customers, plans, plan-groups, data-sources, invoices
`export_csv`	Export customers or MRR movements as CSV

Settings & Integrations

Tool	Description
`manage_settings`	Get/update account and integration settings
`manage_webhooks`	Manage webhook subscriptions (list, create, delete, verify, sample)

Account Management

Tool	Description
`manage_account`	Get, update, or delete the account
`manage_billing`	Billing details, invoices, subscriptions, payment methods
`manage_team`	Team members: list, invite, edit roles, remove
`manage_api_keys`	API key management: list, create, update, delete

Generic Passthrough

Tool	Description
`api_request`	Call any API endpoint directly (method + path + params/body)

The api_request tool supports any API endpoint. New features added to the GrowPanel API are immediately available through this tool without needing an MCP server update.

Example Prompts

Once connected, you can ask your AI assistant:

"What's my current MRR?"
"Show me MRR trends for the last 6 months"
"List my top customers by revenue"
"What's my churn rate?"
"Show me the cohort retention analysis"
"How many leads converted this quarter?"
"List all my webhook subscriptions"
"What are my current settings?"

Self-Updating Architecture

The MCP server uses the same dynamic architecture as the GrowPanel CLI:

get_report accepts any report name and passes it through to /reports/<name>. New reports work automatically.
api_request can call any API endpoint. New API features work on day one.
Named tools (manage_data, manage_settings, etc.) provide better descriptions for AI understanding, but the passthrough ensures nothing is missed.

Development

npm install
npm run dev          # Run from source via tsx
npm run build        # Compile TypeScript
npm run typecheck    # Type checking only
npm start            # Run built version

Requirements

Node.js 20+
GrowPanel account with API key

License

MIT