RevKeen MCP Server

Model Context Protocol server for AI assistants like Claude, Cursor, and VS Code

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 & Reporting

  • • Revenue metrics and MRR
  • • Payment success rates
  • • Customer growth trends

Installation

Claude Desktop

Add to your claude_desktop_config.json:

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

ToolDescription
list_customersList and search customers with filters
get_customerGet customer details by ID or email
list_subscriptionsList subscriptions with status filters
get_subscriptionGet subscription details and history
list_invoicesList invoices by status or customer
get_invoiceGet invoice details and line items
list_productsList available products and prices
get_metricsGet revenue metrics (MRR, ARR, churn)
searchSemantic 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'll be prompted to authorize access through the RevKeen dashboard.

Managing Connected Apps

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.

Related Resources