> ## Documentation Index
> Fetch the complete documentation index at: https://acm-aa28ebf6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Publish and use MCP servers with SuperBox

## For developers: publishing a server

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    pip install superbox
    ```
  </Step>

  <Step title="Authenticate">
    ```bash theme={null}
    superbox auth login
    ```

    Follow the device flow instructions to authenticate via browser.
  </Step>

  <Step title="Initialize server metadata">
    ```bash theme={null}
    superbox init
    ```

    Provide your server name, repository URL, description, and entrypoint file.
  </Step>

  <Step title="Publish to the registry">
    ```bash theme={null}
    superbox push
    ```

    This runs the full security pipeline:

    * SonarCloud static analysis
    * MCP tool discovery
    * Snyk dependency vulnerability scan
    * GitGuardian secret detection
    * Bandit Python security linting
    * Upload metadata to the R2 registry
  </Step>
</Steps>

## For users: connecting a server to your AI client

<Steps>
  <Step title="Browse available servers">
    Visit [superbox.1mindlabs.org/explore](https://superbox.1mindlabs.org/explore) to find published servers.
  </Step>

  <Step title="Install the CLI">
    ```bash theme={null}
    pip install superbox
    ```
  </Step>

  <Step title="Pull the server config">
    ```bash theme={null}
    superbox pull --name weather-server --client cursor
    ```

    Supported clients: `vscode`, `cursor`, `antigravity`, `claude`, `chatgpt`.

    This writes the MCP configuration for your client. VS Code receives an HTTP-type entry pointing directly to the Cloudflare Worker. All other clients (Cursor, Antigravity, Claude, ChatGPT) receive an `npx mcp-remote` stdio bridge entry.
  </Step>
</Steps>

## API usage

<Steps>
  <Step title="List all servers">
    ```bash theme={null}
    curl https://api.superbox.ai/api/v1/servers
    ```
  </Step>

  <Step title="Get server details">
    ```bash theme={null}
    curl https://api.superbox.ai/api/v1/servers/weather-server
    ```
  </Step>

  <Step title="Connect to your AI client">
    ```bash theme={null}
    superbox pull --name weather-server --client vscode
    ```

    The server appears in your AI client's MCP tools list immediately.
  </Step>
</Steps>

## Next steps

<CardGroup cols={3}>
  <Card title="API reference" icon="book" href="/api/introduction">
    All endpoints
  </Card>

  <Card title="CLI commands" icon="terminal" href="/cli/introduction">
    Full command reference
  </Card>

  <Card title="Authentication" icon="key" href="/api/authentication">
    Auth flow details
  </Card>

  <Card title="Error handling" icon="triangle-exclamation" href="/api/errors">
    Handle API errors
  </Card>

  <Card title="Architecture" icon="sitemap" href="/architecture">
    System design
  </Card>

  <Card title="Security" icon="shield" href="/concepts/security">
    Security pipeline
  </Card>
</CardGroup>