Organizations

Organizations are the foundational unit of multi-tenancy in MCP Hub. They allow teams and enterprises to collaborate on MCP server management with shared resources, policies, and governance controls. Every Enterprise feature – from RBAC to governance policies to audit logging – operates within the context of an organization.

Creating an Organization

To create an organization, you must have an Enterprise plan. Navigate to your dashboard and select Create Organization, or use the API:

POST /api/v1/orgs

{
  "name": "acme-corp",
  "slug": "acme",
  "display_name": "ACME Corporation"
}

When creating an organization, you provide three identifiers:

• Name: The full organization name (up to 255 characters).
• Slug: A URL-safe identifier used in paths and subdomains (lowercase letters, numbers, and hyphens only, matching the pattern ^[a-z][a-z0-9-]{2,49}$). The slug cannot be changed after creation.
• Display Name: A human-readable label shown in the dashboard and reports.

The user who creates the organization is automatically assigned the Owner role with full administrative privileges.

Organization Settings

Organization owners and admins can configure the following settings from the organization detail page:

General Settings

• Display Name and Description: Update the publicly visible name and description at any time.
• Avatar: Upload a logo or avatar for the organization.
• SSO Configuration: Enterprise organizations can configure Single Sign-On via SAML 2.0 or OIDC. Configure the SSO provider (Auth0, Okta, Azure AD), domain, and metadata through the SSO settings panel.

Dedicated Subdomain

Enterprise organizations can receive a dedicated subdomain for their registry endpoint:

acme.registry.mcp-hub.info

This dedicated subdomain enables enforcement-by-download governance, where the organization controls which MCPs can be downloaded through their corporate proxy and firewall rules.

Plan and Status

Organizations have a plan (FREE, PRO, or ENTERPRISE) and a status (ACTIVE, SUSPENDED, or DELETED). Only platform administrators can change the organization plan or suspend an organization.

Member Management

Inviting Members

Organization owners and admins can invite new members by email:

POST /api/v1/orgs/{orgId}/users/invite

{
  "email": "[email protected]",
  "role": "MEMBER"
}

Invitations are valid for 7 days and include a unique acceptance token. The invited user receives an email with a link to accept the invitation.

Organization Roles

Each member in an organization holds one of four roles:

Key permission differences:

• Owner: Can delete the organization, manage billing, transfer ownership, and assign/remove any role. Only one Owner per organization.
• Admin: Can invite and remove members, create policies, manage service tokens, view audit logs, and generate PDF reports. Cannot delete the organization or manage billing.
• Member: Can publish and update MCPs under the organization namespace, view snapshots, and export data. Cannot manage organizational settings.
• Viewer: Can view MCPs, policies, and members. Downloads are subject to organization policies.

Managing Roles

Owners can assign any role. Admins can assign roles below their own level (Member or Viewer). The role hierarchy follows the rule that you can only assign roles at or below your own level, and you cannot modify users at your same level or above.

Removing Members

Organization owners and admins can remove members from the organization. Removing a member revokes their access to all organization resources, including areas and private MCPs.

Billing Per Organization

MCP Hub integrates with Stripe for subscription billing. Billing is managed at the organization level by the organization Owner.

Subscription Tiers

Managing Subscriptions

The organization Owner can manage billing from the Settings > Billing page in the dashboard. This includes:

• Upgrading or downgrading the subscription plan.
• Choosing billing cycle: Monthly or yearly (yearly saves approximately 16%).
• Accessing the Stripe Customer Portal: Manage payment methods, view invoices, and cancel subscriptions directly through Stripe’s hosted portal.

Subscription Synchronization

Subscription status is automatically synchronized via Stripe webhooks. When a payment succeeds, fails, or a subscription is cancelled, MCP Hub updates the organization’s plan status in real time. The following Stripe events are processed:

• checkout.session.completed – Initial subscription creation.
• customer.subscription.updated – Plan changes.
• customer.subscription.deleted – Cancellation.
• invoice.payment_succeeded – Successful payment recorded.
• invoice.payment_failed – Failed payment flagged.

When a subscription is cancelled, the organization is downgraded to the Free plan, and Enterprise features become unavailable. Data is preserved and can be restored by reactivating the subscription.

Organization Statistics

The organization detail page displays key metrics:

• Total Members: Active member count by role distribution.
• Total MCPs: Number of MCP servers registered under the organization.
• Active Policies: Number of enabled governance policies.
• Service Tokens: Number of active API tokens for CI/CD integration.

These statistics help organization owners monitor adoption and resource utilization across their team.