Set Up an Organization

Organizations are the core unit of team management in MCP Hub Platform. They provide shared namespaces for MCP servers, role-based access control, billing management, and security policy enforcement. This tutorial walks you through creating and configuring an organization from scratch.

Before You Begin

You need:

• A running MCP Hub Platform instance (see Quick Start)
• An authenticated user account in the Hub dashboard

Step 1: Create an Organization

Via the Web Dashboard

1. Open the Hub dashboard at http://localhost:8080
2. Click your avatar or username in the top-right corner
3. Select Create Organization
4. Fill in the organization details:

5. Click Create

You are automatically assigned the Owner role for the new organization.

Naming Conventions

Organization names serve as namespaces for MCP servers. Choose carefully, as the name becomes part of the package identifier:

@acme-corp/[email protected]
 ^^^^^^^^^
 org namespace

Organization names must be:

• Lowercase letters, numbers, and hyphens only
• Between 3 and 40 characters
• Unique across the platform
• Cannot start or end with a hyphen

Step 2: Configure Organization Settings

Navigate to your organization page and open Settings. Key configuration options:

General Settings

• Display Name: Shown in the dashboard and public profiles
• Description: Appears on the organization listing page
• Contact Email: Used for billing and administrative notifications
• Website: Public URL for your organization

Security Defaults

Set default security policies that apply to all MCP servers in the organization:

• Minimum Certification Level: The lowest certification level allowed for execution (0-3)
• Allowed Origins: Which origin types can be used (Official, Verified, Community)
• Auto-Certify on Push: Whether to trigger certification automatically on new pushes

These defaults can be overridden per-server or per-area (see Enforce Security Policies).

Step 3: Invite Team Members

Sending Invitations

1. Navigate to your organization > Members
2. Click Invite Member
3. Enter the member’s email address
4. Select a role (see the role table below)
5. Click Send Invitation

The invitee receives an email with a link to join the organization. Invitations expire after 7 days.

Bulk Invitations

For larger teams, use the bulk invite feature:

1. Click Bulk Invite
2. Enter email addresses (one per line) or upload a CSV file
3. Select the default role for all invitees
4. Click Send All

Role-Based Access Control (RBAC)

MCP Hub Platform provides four organization roles with increasing permissions:

Permission Matrix

Changing Roles

To change a member’s role:

1. Go to Members and find the member
2. Click the role dropdown next to their name
3. Select the new role
4. Confirm the change

Step 4: Configure Areas and Namespaces

Areas let you organize MCP servers into logical groups within an organization. Think of them as folders or teams within your organization.

Creating Areas

1. Navigate to your organization > Areas
2. Click Create Area
3. Fill in the details:

Area-Specific Policies

Each area can have its own security policies that override the organization defaults:

Organization Defaults (min cert level: 1)
    |
    +--- Area: backend-tools (min cert level: 2)
    |        |
    |        +--- Server: db-connector (inherits: 2)
    |        +--- Server: api-gateway (override: 3)
    |
    +--- Area: frontend-tools (inherits: 1)
             |
             +--- Server: ui-builder (inherits: 1)

Policy inheritance flows from organization to area to individual server, with each level able to set more restrictive (but not more permissive) policies.

Assigning Servers to Areas

When adding or editing an MCP server, select the area it belongs to. Servers without an area assignment fall under the organization’s default policies.

Step 5: Set Up Billing (Optional)

If your platform uses Stripe-based billing:

1. Navigate to your organization > Billing
2. Click Set Up Billing
3. Enter payment details through the Stripe checkout
4. Choose a plan tier

Billing is managed at the organization level. All members share the organization’s plan and usage limits.

Managing Your Organization Day-to-Day

Audit Log

The organization audit log tracks all administrative actions:

• Member invitations and role changes
• Policy modifications
• Server additions and deletions
• Billing changes

Access it via Settings > Audit Log.

Removing Members

1. Go to Members
2. Find the member and click Remove
3. Confirm the removal

Removed members immediately lose access to all organization resources. Their published MCP servers remain in the organization namespace.

Transferring Ownership

To transfer organization ownership:

1. Ensure the target member already has the Owner role
2. Go to Settings > Transfer Ownership
3. Select the new primary owner
4. Confirm with your password

Deleting an Organization

To delete an organization:

1. Go to Settings > Danger Zone
2. Click Delete Organization
3. Type the organization name to confirm
4. Enter your password and confirm

Next Steps

• Enforce Security Policies – Configure policies for your organization
• Publish from GitHub – Connect GitHub repositories to your organization
• Self-Hosted Deployment – Deploy the platform on your own infrastructure