Billing & Subscriptions
5 min read
MCP Hub uses Stripe for all payment processing. Subscriptions are managed at the user level for individual plans and at the organization level for Enterprise plans. The billing system supports automatic renewals, plan upgrades and downgrades, and a self-service customer portal.
Subscription Tiers
Free
The Free tier provides access to the public MCP catalog with basic features and limited quotas.
| Feature | Limit |
|---|---|
| Public MCPs | 5 |
| Private MCPs | 0 |
| Downloads | 30/minute |
| Watchlist items | 10 |
| Registry tokens | 3 |
| API access | No |
| Organizations | No |
| PDF reports | No |
| Support | Community |
The Free tier requires registration but no payment method. It is designed for individual developers exploring the MCP ecosystem and evaluating tools.
PRO
The PRO plan unlocks private repositories, full analysis capabilities, API access, and significantly higher rate limits.
Pricing: 12 EUR/month or 120 EUR/year (save approximately 16%).
| Feature | Limit |
|---|---|
| Public MCPs | 50 |
| Private MCPs | 20 |
| Downloads | 300/minute |
| Watchlist items | 100 |
| Registry tokens | 10 |
| API access | Yes (300 req/min) |
| Export (JSON/CSV) | Yes |
| Custom alerts | Yes |
| Webhooks | Yes |
| Organizations | No |
| PDF reports | No |
| Support |
The PRO plan is suitable for professional developers and small teams that need private MCP management and API integration but do not require organizational governance features.
Enterprise
The Enterprise plan provides the full platform with multi-tenancy, RBAC, governance policies, audit logging, dedicated subdomains, and compliance reporting.
Pricing: Custom (contact sales).
| Feature | Limit |
|---|---|
| Public MCPs | Unlimited |
| Private MCPs | Unlimited |
| Downloads | Unlimited |
| Watchlist items | Unlimited |
| Registry tokens | Unlimited |
| API access | Yes (5000 req/min) |
| Organizations | Unlimited |
| Members per org | Unlimited |
| Governance policies | Unlimited |
| CI/CD gating | Yes |
| PDF reports | Yes |
| Dedicated subdomain | Yes |
| Audit logging | Yes |
| SSO (SAML/OIDC) | Yes |
| Support | Priority with SLA |
Stripe Integration
How Payments Work
MCP Hub integrates with Stripe Checkout for secure payment processing:
- Checkout initiation: When a user clicks “Upgrade to PRO”, the platform creates a Stripe Checkout Session with the selected pricing (monthly or yearly).
- Payment processing: The user is redirected to Stripe’s hosted checkout page to enter payment details securely. MCP Hub never handles raw credit card data.
- Confirmation: After successful payment, Stripe redirects the user back to MCP Hub and sends webhook events to confirm the subscription.
- Plan activation: MCP Hub processes the webhook, creates a subscription record, and upgrades the user’s plan to PRO.
Webhook Synchronization
Stripe communicates subscription lifecycle events to MCP Hub via webhooks. The following events are processed:
| Event | Action |
|---|---|
checkout.session.completed | Create subscription, upgrade user plan |
customer.subscription.created | Record new subscription |
customer.subscription.updated | Update subscription status (plan change, renewal) |
customer.subscription.deleted | Mark subscription cancelled, downgrade to Free |
invoice.payment_succeeded | Record payment in payment history |
invoice.payment_failed | Flag payment failure, notify user |
Webhook payloads are verified using the Stripe-Signature header and the webhook signing secret to prevent spoofed events.
Payment Security
- No raw card data: All payment processing happens on Stripe’s infrastructure. MCP Hub never sees or stores credit card numbers.
- Webhook signature verification: Every webhook is cryptographically verified before processing.
- HTTPS required: All Stripe communication uses HTTPS.
- Fraud detection: Stripe Radar provides automatic fraud screening.
Managing Subscriptions
Upgrading to PRO
- Navigate to Settings > Billing in the dashboard.
- Click Upgrade to Pro.
- Select your billing cycle: Monthly (12 EUR/month) or Yearly (120 EUR/year).
- Complete the Stripe Checkout form with your payment details.
- After successful payment, your plan is immediately upgraded.
Changing Billing Cycle
To switch between monthly and yearly billing, use the Stripe Customer Portal (see below). The change takes effect at the next billing cycle.
Cancelling a Subscription
- Navigate to Settings > Billing.
- Click Manage Subscription to open the Stripe Customer Portal.
- Select Cancel Subscription.
- Your PRO features remain active until the end of the current billing period.
- After the period ends, your plan is automatically downgraded to Free.
Data is preserved after cancellation. Private MCPs, watchlists, and historical data remain accessible if you resubscribe.
Reactivating a Subscription
If your subscription was cancelled, you can resubscribe at any time by going through the upgrade flow again. Your previous data and settings are restored.
Stripe Customer Portal
The Stripe Customer Portal is a hosted page where users can self-manage their subscriptions without contacting support. Access it from Settings > Billing > Manage Subscription.
From the Customer Portal, you can:
- Update payment method: Add or change credit/debit cards.
- View invoices: Download PDF invoices for all past payments.
- Change billing cycle: Switch between monthly and yearly plans.
- Cancel subscription: End your subscription at the end of the current period.
- View billing history: See all charges, payments, and credits.
After making changes in the Customer Portal, you are redirected back to MCP Hub, and any subscription changes are synchronized via webhooks.
Subscription Data
MCP Hub tracks subscription data in the database for internal use and analytics:
Subscription Record
Each active subscription stores:
- User ID and Stripe Customer ID
- Plan type (PRO or ENTERPRISE)
- Subscription status (active, cancelled, past_due)
- Current billing period start and end dates
- Stripe Subscription ID for reference
Payment History
Each payment is recorded with:
- Amount and currency
- Payment status (succeeded, failed)
- Payment date
- Invoice reference
- Associated subscription
Revenue Metrics
Platform administrators can monitor:
- Monthly Recurring Revenue (MRR)
- Active subscription count by plan
- Churn rate (cancellations in the last 30 days)
- Payment failure rate
Enterprise Billing
Enterprise subscriptions are handled through custom agreements and invoicing. They are typically configured by platform administrators after a sales engagement:
- Platform admin creates the organization via the admin panel.
- The organization plan is set to ENTERPRISE.
- Billing is arranged separately (annual contracts, purchase orders, etc.).
- The Enterprise plan does not use Stripe Checkout – it is managed directly.
For Enterprise organizations, the Owner role has access to billing configuration, but the actual payment arrangements are managed outside the platform.
Testing with Test Cards
In development and staging environments, use Stripe test mode with the following test card numbers:
| Card Number | Result |
|---|---|
4242 4242 4242 4242 | Successful payment |
4000 0000 0000 3220 | 3D Secure authentication required |
4000 0000 0000 0002 | Card declined |
Use any future expiry date, any 3-digit CVC, and any postal code.