Skip to main content

​
For Developers: Publishing MCP Servers

1

Install CLI

pip install superbox
2

Authenticate

superbox auth login
Follow the device flow instructions to authenticate via browser.
3

Initialize Your Server

superbox init
Provide server details: name, repository URL, description, entrypoint file.
4

Push to Registry

superbox push
This will:
  • Run SonarCloud analysis on your repository
  • Scan for security issues with Bandit and GitGuardian
  • Discover MCP tools in your code
  • Upload metadata to S3

​
For Users: Using MCP Servers

1

Browse Servers

Visit SuperBox to browse available MCP servers.
2

Install CLI

pip install superbox
3

Pull Server Configuration

superbox pull weather-server --client cursor
Supports: vscode, cursor, windsurf, claude, chatgpt
4

Test the Server

superbox run --name weather-server
Interactive terminal session to test server tools.

​
API Usage

1

List All Servers

curl https://api.superbox.ai/api/v1/servers
Response includes server metadata, tools, pricing, and security reports.
2

Get Server Details

curl https://api.superbox.ai/api/v1/servers/weather-server
3

Execute MCP Server

Send JSON-RPC requests to the Lambda endpoint:
curl -X POST https://{lambda-url}/weather-server \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/call", "params": {"name": "get_weather", "arguments": {"city": "NYC"}}}'

​
Next Steps

API Reference

Explore all endpoints

CLI Tools

Learn CLI commands

Authentication

Auth flow details

Error Handling

Handle API errors

Architecture

System design

Security

Security pipeline