> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ultra.security/llms.txt
> Use this file to discover all available pages before exploring further.

# Ultra Hub Overview

> Centralized management for MCP security

Ultra Hub is the cloud control plane for managing MCP security across teams and organizations. It provides centralized visibility, gateway management, and team collaboration.

## What Hub Provides

<CardGroup cols={2}>
  <Card title="Gateway Registry" icon="server">
    Register and monitor Ultra gateways across your organization. Track which gateways are online, their sync status, and health.
  </Card>

  <Card title="Synced Telemetry" icon="chart-mixed">
    Traces and audit events from all gateways are synced to Hub for team-wide visibility. One dashboard for all MCP traffic.
  </Card>

  <Card title="Organization Management" icon="building">
    Manage organizations, teams, and workspaces. Invite members and control access.
  </Card>

  <Card title="Workspace Isolation" icon="folder-tree">
    Group gateways into workspaces for environment separation (e.g., Development, Staging, Production).
  </Card>
</CardGroup>

## Architecture

```mermaid theme={null}
graph LR
    subgraph Devs["<b>Developer Machines</b>"]
        direction TB
        GW1["Gateway (Alice)"]
        GW2["Gateway (Bob)"]
        GW3["Gateway (CI/CD)"]
    end

    subgraph Hub["<b>Ultra Hub</b>"]
        direction TB
        Org["<b>Organization</b>"]
        T1["Team"]
        T2["Team"]
        W1["Workspace"]
        W2["Workspace"]
        W3["Workspace"]
        HubG1["Gateway"]
        HubG2["Gateway"]
        HubG3["Gateway"]
        Dashboard["Dashboard<br/>Traces · Audit"]

        Org --> T1
        Org --> T2
        T1 --> W1
        T1 --> W2
        T2 --> W3
        W1 --> HubG1
        W2 --> HubG2
        W3 --> HubG3
        HubG1 --> Dashboard
        HubG2 --> Dashboard
        HubG3 --> Dashboard
    end

    GW1 -.->|sync| HubG1
    GW2 -.->|sync| HubG2
    GW3 -.->|sync| HubG3
```

An organization can contain many teams, each with many workspaces, each with many registered gateways.

Each developer runs Ultra locally as a gateway. Gateways link to a workspace and periodically sync traces and audit events to Hub. The Hub dashboard provides a unified view of all MCP activity.

## Getting Started

<Steps>
  <Step title="Sign up">
    Visit [hub.ultra.security](https://hub.ultra.security) and create an account.
  </Step>

  <Step title="Complete onboarding">
    The onboarding wizard walks you through creating an organization, team, and workspace.
  </Step>

  <Step title="Login from CLI">
    ```bash theme={null}
    ultra login
    ```
  </Step>

  <Step title="Link your gateway">
    ```bash theme={null}
    ultra link
    ```
  </Step>

  <Step title="Start Ultra">
    ```bash theme={null}
    ultra start
    ```

    Traces and audit events will now sync to Hub automatically.
  </Step>
</Steps>

## Hub API

Hub exposes a REST API for gateway management:

| Endpoint                               | Description         |
| -------------------------------------- | ------------------- |
| `GET /health`                          | Health check        |
| `GET /api/v1/organizations`            | List organizations  |
| `POST /api/v1/organizations`           | Create organization |
| `GET /api/v1/organizations/:org/teams` | List teams          |
| `GET /api/v1/workspaces`               | List workspaces     |
| `POST /api/v1/gateways/register`       | Register gateway    |
| `POST /api/v1/gateways/:id/sync`       | Sync gateway data   |
| `POST /api/v1/gateways/:id/heartbeat`  | Gateway heartbeat   |

## Self-Hosted

Ultra Hub can be self-hosted for organizations that need to keep data on-premises:

```bash theme={null}
ultra hub start --dev  # Local development
```

Production deployments require external storage and identity provider configuration. See the [Hub command reference](/cli/hub) for configuration options.