Billing & Subscriptions

Subscription tiers (Free, PRO, Enterprise), Stripe integration, managing subscriptions, and the customer portal.

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.

FeatureLimit
Public MCPs5
Private MCPs0
Downloads30/minute
Watchlist items10
Registry tokens3
API accessNo
OrganizationsNo
PDF reportsNo
SupportCommunity

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%).

FeatureLimit
Public MCPs50
Private MCPs20
Downloads300/minute
Watchlist items100
Registry tokens10
API accessYes (300 req/min)
Export (JSON/CSV)Yes
Custom alertsYes
WebhooksYes
OrganizationsNo
PDF reportsNo
SupportEmail

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).

FeatureLimit
Public MCPsUnlimited
Private MCPsUnlimited
DownloadsUnlimited
Watchlist itemsUnlimited
Registry tokensUnlimited
API accessYes (5000 req/min)
OrganizationsUnlimited
Members per orgUnlimited
Governance policiesUnlimited
CI/CD gatingYes
PDF reportsYes
Dedicated subdomainYes
Audit loggingYes
SSO (SAML/OIDC)Yes
SupportPriority with SLA

Stripe Integration

How Payments Work

MCP Hub integrates with Stripe Checkout for secure payment processing:

  1. Checkout initiation: When a user clicks “Upgrade to PRO”, the platform creates a Stripe Checkout Session with the selected pricing (monthly or yearly).
  2. 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.
  3. Confirmation: After successful payment, Stripe redirects the user back to MCP Hub and sends webhook events to confirm the subscription.
  4. 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:

EventAction
checkout.session.completedCreate subscription, upgrade user plan
customer.subscription.createdRecord new subscription
customer.subscription.updatedUpdate subscription status (plan change, renewal)
customer.subscription.deletedMark subscription cancelled, downgrade to Free
invoice.payment_succeededRecord payment in payment history
invoice.payment_failedFlag 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

  1. Navigate to Settings > Billing in the dashboard.
  2. Click Upgrade to Pro.
  3. Select your billing cycle: Monthly (12 EUR/month) or Yearly (120 EUR/year).
  4. Complete the Stripe Checkout form with your payment details.
  5. 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

  1. Navigate to Settings > Billing.
  2. Click Manage Subscription to open the Stripe Customer Portal.
  3. Select Cancel Subscription.
  4. Your PRO features remain active until the end of the current billing period.
  5. 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:

  1. Platform admin creates the organization via the admin panel.
  2. The organization plan is set to ENTERPRISE.
  3. Billing is arranged separately (annual contracts, purchase orders, etc.).
  4. 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 NumberResult
4242 4242 4242 4242Successful payment
4000 0000 0000 32203D Secure authentication required
4000 0000 0000 0002Card declined

Use any future expiry date, any 3-digit CVC, and any postal code.