Skip to main content

​
Usage

superbox run --name NAME

​
Description

Start an interactive terminal session to test an MCP server through the Lambda executor. Send requests and view responses in real-time.

​
Options

​
--name
string
required
MCP server name to run (must exist in registry)

​
What It Does

1

Connect to Executor

Connects to the Lambda executor endpoint
2

Interactive Prompt

Provides interactive prompt for sending requests
3

Send Requests

Type prompts and send to MCP server
4

View Responses

Displays JSON responses from the server

​
Interactive Session

$ superbox run --name weather-mcp
Connecting to MCP executor: https://lambda-url/weather-mcp
Type 'exit' or 'quit' to end. Press Enter on empty line to continue.

> What tools are available?
{
  "tools": [
    "get_weather",
    "get_forecast",
    "get_historical"
  ]
}

> Get weather for London
{
  "result": {
    "location": "London",
    "temperature": "15°C",
    "conditions": "Cloudy"
  }
}

> exit
Goodbye!

​
Commands

Within the interactive session:
  • Type your prompt and press Enter to send request
  • Type exit or quit to end session
  • Press Enter on empty line to continue

​
Example

$ superbox run --name my-mcp
Connecting to MCP executor: https://lambda-url/my-mcp
Type 'exit' or 'quit' to end. Press Enter on empty line to continue.
> What's the weather today?
{
  "response": "Weather data retrieved successfully"
}

​
Next Steps

Push Server

Publish to SuperBox

Run Tests

Execute test suite