superbox run

Deprecated - use superbox pull to configure AI clients

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.

What the command does

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:

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:

# 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

pull

Configure MCP servers in AI clients

test

Test an unreleased server from GitHub