@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://app.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

Getting Started

After installing, ask your AI assistant:

"Set up Capivv for my iOS app com.mycompany.myapp with a monthly ($7.99) and annual ($49.99) subscription"

The assistant will use capivv_setup_wizard to create everything in one shot. Or go step-by-step:

1. capivv_next_step — tells you exactly what to do next based on your current setup
2. capivv_setup_wizard — creates app + entitlement + products + offering in one call
3. capivv_verify_setup — checks everything is configured correctly

Read the capivv://docs/quickstart resource for a full walkthrough.

Available Tools

Identity

| Tool | Description | |------|-------------| | capivv_whoami | Show which workspace (org) and apps your API key reaches. Call this first if anything looks wrong |

Onboarding & Guidance

| Tool | Description | |------|-------------| | capivv_next_step | Analyze your setup and get exact instructions for the next step | | capivv_setup_wizard | One-shot setup: app + entitlement + products + offering in one call | | capivv_verify_setup | Pass/fail checklist verifying your entire setup with fix instructions |

Status & Analytics

| Tool | Description | |------|-------------| | capivv_status | Get setup progress, resource counts, and key metrics | | capivv_get_analytics | Get MRR, ARR, churn rate, ARPU, and period comparison |

Apps

| Tool | Description | |------|-------------| | capivv_list_apps | List all apps with platform and bundle ID | | capivv_create_app | Register a new app (iOS, Android, or Web) |

Entitlements

| Tool | Description | |------|-------------| | capivv_list_entitlements | List all entitlements (feature access identifiers) | | capivv_create_entitlement | Create a new entitlement |

Products

| Tool | Description | |------|-------------| | capivv_list_products | List products with store IDs and entitlements (optional app_id filter) | | capivv_create_product | Create a subscription, consumable, or non-consumable product | | capivv_update_product | Update product fields (name, entitlements, external ID) | | capivv_delete_product | Delete a product (irreversible) | | capivv_import_products | Preview store product import from App Store Connect / Google Play |

Offerings

| Tool | Description | |------|-------------| | capivv_list_offerings | List offerings with packages and products | | capivv_create_offering | Create a new offering with packages |

Rules

| Tool | Description | |------|-------------| | capivv_list_rules | List YAML business rules with status and priority | | capivv_apply_rule | Validate and apply a YAML rule configuration | | capivv_activate_rule | Activate an existing rule | | capivv_delete_rule | Delete a rule (irreversible) |

Experiments

| Tool | Description | |------|-------------| | capivv_list_experiments | List A/B experiments with results and confidence |

Available Resources

| URI | Description | |-----|-------------| | capivv://docs/quickstart | Step-by-step setup guide — start here | | capivv://docs/guides/ios | Complete iOS integration guide with code examples | | capivv://docs/guides/ai-prompts | Ready-to-use prompts for AI code generators (Lovable, Bolt, Cursor) | | 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