@voltbee/mcp-server

Model Context Protocol (MCP) server for VoltBee. Enables AI agents like Claude, GPT, and others to directly interact with VoltBee APIs.

What is MCP?

Model Context Protocol is a standard for AI models to interact with external tools and APIs. This server allows AI assistants to:

• Create and manage products
• Generate checkout links
• Verify licenses
• View analytics
• Manage subscriptions

Installation

npm install -g @voltbee/mcp-server

Configuration

With Claude Desktop

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

{
  "mcpServers": {
    "voltbee": {
      "command": "npx",
      "args": ["@voltbee/mcp-server"],
      "env": {
        "VOLTBEE_API_KEY": "vb_live_your_api_key_here"
      }
    }
  }
}

With Other MCP Clients

Set environment variables:

export VOLTBEE_API_KEY="vb_live_your_api_key_here"
export VOLTBEE_API_URL="https://api.voltbee.dev"  # Optional, defaults to production

Then run:

npx @voltbee/mcp-server

Available Tools

create_product

Create a new product to monetize.

{
  "name": "My Extension",
  "platform": "browser",
  "description": "A helpful browser extension",
  "plans": [
    {
      "name": "Pro",
      "price": 999,
      "interval": "month",
      "features": ["Unlimited usage", "Priority support"]
    }
  ]
}

list_products

List all products in your account.

{
  "platform": "browser", // Optional filter
  "limit": 50
}

create_checkout

Generate a payment link.

{
  "product_id": "prod_abc123",
  "email": "[email protected]",
  "success_url": "https://myapp.com/success",
  "cancel_url": "https://myapp.com/cancel"
}

Returns:

{
  "success": true,
  "checkout_url": "https://checkout.stripe.com/...",
  "session_id": "cs_xxx"
}

verify_license

Check if a license key is valid.

{
  "license_key": "XXXX-XXXX-XXXX-XXXX",
  "device_id": "optional-device-id"
}

Returns:

{
  "valid": true,
  "license": {
    "status": "active",
    "plan": "Pro",
    "email": "[email protected]",
    "expires_at": "2025-03-01T00:00:00Z"
  }
}

get_analytics

Get revenue and subscription metrics.

{
  "product_id": "prod_abc123",
  "period": "month"
}

Returns:

{
  "success": true,
  "metrics": {
    "revenue": {
      "mrr": 9900,
      "arr": 118800,
      "total": 24500
    },
    "subscriptions": {
      "active": 100,
      "new": 15,
      "churned": 3,
      "churn_rate": "3.00%"
    }
  }
}

manage_subscription

View, cancel, pause, or resume subscriptions.

{
  "action": "cancel",
  "subscription_id": "sub_xxx",
  "cancel_at_period_end": true,
  "reason": "Customer requested"
}

Example Conversations

Once configured, you can ask your AI assistant things like:

"Create a new browser extension product called 'TabMaster Pro' with a $4.99/month plan"

"How many subscribers do I have for my VS Code extension?"

"Generate a checkout link for [email protected] for my Pro plan"

"Is license key ABC-123-DEF-456 valid?"

"Cancel the subscription for [email protected]"

Development

# Clone the repo
git clone https://github.com/voltbee/voltbee.git
cd voltbee/mcp-server

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run locally
VOLTBEE_API_KEY=vb_test_xxx npm start

API Reference

For full API documentation, see:

• VoltBee API Docs
• OpenAPI Spec

License

MIT