@capivv/mcp-server

MCP (Model Context Protocol) server for the Capivv subscription management platform. Enables AI assistants like Claude, Cursor, and other MCP clients to manage your in-app subscription configuration.

Installation

# Run directly with npx (recommended)
npx @capivv/mcp-server

# Or install globally
npm install -g @capivv/mcp-server
capivv-mcp

Configuration

The server requires an API key from your Capivv dashboard.

| Environment Variable | Required | Description | |---------------------|----------|-------------| | CAPIVV_API_KEY | Yes | API key from Settings > Developer > API Keys | | CAPIVV_API_URL | No | API base URL (default: https://api.capivv.com) | | CAPIVV_ORG_ID | No | Organization ID for multi-org accounts |

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "capivv": {
      "command": "npx",
      "args": ["-y", "@capivv/mcp-server"],
      "env": {
        "CAPIVV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Config file location:

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

Claude Code

claude mcp add capivv -- npx -y @capivv/mcp-server

Set the API key in your environment or .env file:

export CAPIVV_API_KEY="your-api-key-here"

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "capivv": {
      "command": "npx",
      "args": ["-y", "@capivv/mcp-server"],
      "env": {
        "CAPIVV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Generic MCP Client

The server uses stdio transport. Start it with:

CAPIVV_API_KEY=your-api-key npx @capivv/mcp-server

Available Tools

| Tool | Description | |------|-------------| | capivv_status | Get setup progress, resource counts, and key metrics | | capivv_list_apps | List all apps with platform and bundle ID | | capivv_list_products | List products with store IDs and entitlements (optional app_id filter) | | capivv_import_products | Preview store product import from App Store Connect / Google Play | | capivv_list_offerings | List offerings with packages and products | | capivv_create_offering | Create a new offering with packages | | capivv_list_rules | List YAML business rules with status and priority | | capivv_apply_rule | Validate and apply a YAML rule configuration | | capivv_list_experiments | List A/B experiments with results and confidence | | capivv_get_analytics | Get MRR, ARR, churn rate, ARPU, and period comparison |

Available Resources

| URI | Description | |-----|-------------| | capivv://status | Current platform status as JSON | | capivv://rules/{ruleId} | Individual rule YAML content | | capivv://docs/concepts | Glossary of subscription platform concepts |

Troubleshooting

"CAPIVV_API_KEY is required" Set the CAPIVV_API_KEY environment variable. Get your API key from the Capivv dashboard under Settings > Developer > API Keys.

Tools not appearing in Claude Desktop Restart Claude Desktop after updating claude_desktop_config.json. Check the MCP logs for errors.

Connection errors Verify your API key is valid and your network can reach the Capivv API. If using a custom CAPIVV_API_URL, ensure the URL is correct.

License

MIT