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

# superbox run

> Deprecated - use superbox pull to configure AI clients

<Warning>
  **This command is deprecated.** Running `superbox run` prints a deprecation notice and exits. Use `superbox pull` to configure your AI client, then interact with the server through the client's MCP panel.
</Warning>

## What the command does

```bash theme={null}
superbox run --name NAME
```

When invoked, the command:

1. Prints a deprecation message explaining the change
2. Suggests the equivalent `superbox pull` command
3. Exits with code `0`

No connection to the Worker is made.

## Migration

Use `superbox pull` to configure your AI client for the server:

```bash theme={null}
superbox pull --name weather-server --client cursor
```

Then interact with the server through your AI client's chat or MCP tool panel.

## Sending raw JSON-RPC manually

If you need to send raw JSON-RPC for debugging, use `curl` directly:

```bash theme={null}
# Start a session
curl -s -X POST \
  "https://superbox-executor.<your-subdomain>.workers.dev/mcp?name=weather-server" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: test-session-1" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{}},"id":1}'

# List tools
curl -s -X POST \
  "https://superbox-executor.<your-subdomain>.workers.dev/mcp?name=weather-server" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: test-session-1" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Tear down session
curl -s -X DELETE \
  "https://superbox-executor.<your-subdomain>.workers.dev/mcp?name=weather-server" \
  -H "Mcp-Session-Id: test-session-1"
```

## See Also

<CardGroup cols={2}>
  <Card title="pull" icon="cloud-arrow-down" href="/cli/pull">
    Configure MCP servers in AI clients
  </Card>

  <Card title="test" icon="flask" href="/cli/test">
    Test an unreleased server from GitHub
  </Card>
</CardGroup>