superbox pull

Configure AI client to use an MCP server from the registry

Usage

superbox pull --name NAME --client CLIENT

Description

Pull an MCP server from the S3 registry and configure it for your AI client. Automatically writes the correct MCP configuration file for the specified client using WebSocket cloud execution.

Options

--name · string · required

MCP server name to pull from registry

--client · string · required

Target AI client: vscode, cursor, windsurf, claude, or chatgpt

Supported Clients

VS Code

Configures VS Code MCP settings

Cursor

Configures Cursor MCP settings

Windsurf

Configures Windsurf MCP settings

Claude

Configures Claude Desktop MCP

ChatGPT

Configures ChatGPT MCP settings

How It Works

1. Fetch from S3

   Retrieves server metadata from S3 registry (entrypoint, language, repo URL)

2. Generate Config

   Creates client-specific MCP configuration with local proxy bridge

3. Configure WebSocket

   Points client to WebSocket API via local stdio-WebSocket proxy module

4. Save Config

   Writes configuration to client’s config file location

Architecture

Examples

Cursor

superbox pull --name weather-mcp --client cursor

Example Output

$ superbox pull --name my-mcp --client cursor
Fetching server 'my-mcp' from S3 bucket...
Success!
Server 'my-mcp' added to Cursor MCP config
Location: ~/.cursor/mcp.json

Configuration Format

The generated configuration uses a local proxy that bridges stdio to WebSocket:

{
  "mcpServers": {
    "my-mcp": {
      "command": "python",
      "args": [
        "-m",
        "superbox.aws.proxy",
        "--url",
        "wss://3f382zdysa.execute-api.ap-south-1.amazonaws.com/production?server_name=my-mcp"
      ]
    }
  }
}

Local Proxy Module: Runs python -m superbox.aws.proxy on your machine to bridge stdio (required by AI clients) to WebSocket (cloud executor).

Platform Support

Client	Config Location
VS Code	~/Library/Application Support/Code/User/mcp.json (macOS) %APPDATA%/Code/User/mcp.json (Windows) ~/.config/Code/User/mcp.json (Linux)
Cursor	~/.cursor/mcp.json (macOS/Linux) %USERPROFILE%/.cursor/mcp.json (Windows)
Windsurf	~/Library/Application Support/Windsurf/User/mcp.json (macOS) %APPDATA%/Windsurf/User/mcp.json (Windows) ~/.config/Windsurf/User/mcp.json (Linux)
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) %APPDATA%/Claude/claude_desktop_config.json (Windows) ~/.config/Claude/claude_desktop_config.json (Linux)

Next Steps

Inspect Server

View server details

Test Mode

Test without registry