RevKeen MCP

The RevKeen MCP (Model Context Protocol) server allows AI assistants to interact with your RevKeen account directly. Query customers, check subscriptions, manage invoices, and more through natural language conversations with your AI coding assistant.

MCP is an open protocol developed by Anthropic that enables AI assistants to securely connect to external data sources and tools. Learn more at modelcontextprotocol.io.

What You Can Do

Customer Management -- List and search customers, view customer details and history, create and update customers
Subscription Insights -- Check subscription status, view upcoming renewals, analyze churn patterns
Invoice Operations -- List invoices by status, check payment status, view invoice details
Analytics and Reporting -- Revenue metrics and MRR, payment success rates, customer growth trends

Installation

Claude Desktop

Add to your claude_desktop_config.json:

macOS

{
  "mcpServers": {
    "revkeen": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.revkeen.com/sse"],
      "env": {
        "REVKEEN_API_KEY": "rk_live_your_api_key"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "revkeen": {
      "command": "npx.cmd",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.revkeen.com/sse"],
      "env": {
        "REVKEEN_API_KEY": "rk_live_your_api_key"
      }
    }
  }
}

Config file location:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

VS Code / Cursor

Add to your VS Code settings.json:

{
  "mcp.servers": {
    "revkeen": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://mcp.revkeen.com/sse"],
      "env": {
        "REVKEEN_API_KEY": "rk_live_your_api_key"
      }
    }
  }
}

Claude Code (CLI)

Add via the command line:

claude mcp add revkeen -- npx -y @anthropic-ai/mcp-remote https://mcp.revkeen.com/sse

Then set your API key as an environment variable:

export REVKEEN_API_KEY=rk_live_your_api_key

Available Tools

Tool	Description
`list_customers`	List and search customers with filters
`get_customer`	Get customer details by ID or email
`list_subscriptions`	List subscriptions with status filters
`get_subscription`	Get subscription details and history
`list_invoices`	List invoices by status or customer
`get_invoice`	Get invoice details and line items
`list_products`	List available products and prices
`get_metrics`	Get revenue metrics (MRR, ARR, churn)
`search`	Semantic search across all entities

Example Conversations

You: "Show me all customers who signed up in the last 30 days"

Claude: Uses list_customers with date filter to show new customers with their subscription status and MRR contribution.

You: "What's our current MRR and how does it compare to last month?"

Claude: Uses get_metrics to fetch current and historical MRR, calculating growth percentage and trends.

You: "Find all overdue invoices and show me the total amount outstanding"

Claude: Uses list_invoices with status filter to find overdue invoices, summing amounts and listing affected customers.

OAuth Connection

RevKeen MCP supports OAuth 2.0 for secure authentication. When you first connect, you will be prompted to authorize access through the RevKeen dashboard.

You can view and revoke MCP connections from your RevKeen Dashboard > Settings > Connected Apps.

Security

Your API key grants access to your RevKeen account. Keep it secure and never share it publicly. Use sandbox keys (rk_sandbox_...) for testing.

Read-only by default -- The MCP server primarily performs read operations. Write operations require explicit confirmation.
Scoped permissions -- OAuth tokens are scoped to specific permissions. You control exactly what the MCP server can access.
Revocable access -- Disconnect any MCP app at any time from your dashboard. Tokens are invalidated immediately.