List Servers

curl --request GET \
  --url https://api.example.com/servers

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/servers"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/servers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "total": 2,
  "servers": [
    {
      "name": "weather-mcp",
      "version": "1.2.3",
      "description": "Get weather information for any location using OpenWeatherMap API",
      "author": "areeb",
      "lang": "python",
      "license": "MIT",
      "entrypoint": "main.py",
      "repository": {
        "type": "git",
        "url": "https://github.com/areeb/weather-mcp"
      },
      "tools": {
        "count": 3,
        "names": ["get_weather", "get_forecast", "search_location"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 0
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 0,
          "critical_issues": 0
        }
      }
    },
    {
      "name": "database-query-mcp",
      "version": "2.0.1",
      "description": "Query databases with natural language using AI",
      "author": "janedoe",
      "lang": "typescript",
      "license": "Apache-2.0",
      "entrypoint": "index.ts",
      "repository": {
        "type": "git",
        "url": "https://github.com/janedoe/database-query-mcp"
      },
      "tools": {
        "count": 5,
        "names": ["query", "schema", "execute", "explain", "optimize"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 499
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 2,
          "critical_issues": 0
        }
      }
    }
  ]
}

{
  "status": "error",
  "detail": "Internal server error"
}

GET

servers

List Servers

curl --request GET \
  --url https://api.example.com/servers

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/servers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/servers"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/servers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "total": 2,
  "servers": [
    {
      "name": "weather-mcp",
      "version": "1.2.3",
      "description": "Get weather information for any location using OpenWeatherMap API",
      "author": "areeb",
      "lang": "python",
      "license": "MIT",
      "entrypoint": "main.py",
      "repository": {
        "type": "git",
        "url": "https://github.com/areeb/weather-mcp"
      },
      "tools": {
        "count": 3,
        "names": ["get_weather", "get_forecast", "search_location"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 0
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 0,
          "critical_issues": 0
        }
      }
    },
    {
      "name": "database-query-mcp",
      "version": "2.0.1",
      "description": "Query databases with natural language using AI",
      "author": "janedoe",
      "lang": "typescript",
      "license": "Apache-2.0",
      "entrypoint": "index.ts",
      "repository": {
        "type": "git",
        "url": "https://github.com/janedoe/database-query-mcp"
      },
      "tools": {
        "count": 5,
        "names": ["query", "schema", "execute", "explain", "optimize"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 499
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 2,
          "critical_issues": 0
        }
      }
    }
  ]
}

{
  "status": "error",
  "detail": "Internal server error"
}

Endpoint

GET https://api.superbox.ai/api/v1/servers

Authentication

This endpoint does not require authentication. All registered MCP servers are publicly discoverable.

Query Parameters

string

Filter servers by author/creator username

Response

string

"success" on success, "error" on failure

integer

Total number of servers returned

array

Array of server objects

Show Server Object

string

required

Unique server identifier (lowercase with hyphens)

string

required

Semantic version (e.g., "1.0.0")

string

required

Brief description of the server’s functionality

string

required

Server creator/maintainer name

string

required

Programming language

string

required

Software license (e.g., "MIT", "Apache-2.0")

string

required

Entry point file for server execution

object

required

Repository information

Show properties

string

Repository type (e.g., "git")

string

Repository URL

object

Available tools information

Show properties

integer

Number of tools provided by the server

array

Array of tool names

object

required

Pricing information

Show properties

string

Currency code (e.g., "INR")

number

Price amount (0 for free servers)

object

Security scan summary

Show properties

boolean

Whether the server passed security scans

integer

Total number of issues found across all scanners

integer

Number of critical security issues

Examples

# List all servers
curl -X GET "https://api.superbox.ai/api/v1/servers"

# Filter by author
curl -X GET "https://api.superbox.ai/api/v1/servers?author=areeb"

// List all servers
const response = await fetch('https://api.superbox.ai/api/v1/servers');
const data = await response.json();

console.log(`Found ${data.total} servers`);
data.servers.forEach(server => {
  console.log(`${server.name} v${server.version} - ${server.description}`);
});

// Filter by author
const authorResponse = await fetch(
  'https://api.superbox.ai/api/v1/servers?author=areeb'
);
const authorData = await authorResponse.json();

import requests

# List all servers
response = requests.get('https://api.superbox.ai/api/v1/servers')
data = response.json()

print(f"Found {data['total']} servers")
for server in data['servers']:
    print(f"{server['name']} v{server['version']} - {server['description']}")

# Filter by author
response = requests.get(
    'https://api.superbox.ai/api/v1/servers',
    params={'author': 'areeb'}
)
data = response.json()

package main

import (
"encoding/json"
"fmt"
"net/http"
)

func main() {
resp, err := http.Get("https://api.superbox.ai/api/v1/servers")
if err != nil {
panic(err)
}
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)

fmt.Printf("Found %v servers\n", result["total"])
}

Response Examples

{
  "status": "success",
  "total": 2,
  "servers": [
    {
      "name": "weather-mcp",
      "version": "1.2.3",
      "description": "Get weather information for any location using OpenWeatherMap API",
      "author": "areeb",
      "lang": "python",
      "license": "MIT",
      "entrypoint": "main.py",
      "repository": {
        "type": "git",
        "url": "https://github.com/areeb/weather-mcp"
      },
      "tools": {
        "count": 3,
        "names": ["get_weather", "get_forecast", "search_location"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 0
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 0,
          "critical_issues": 0
        }
      }
    },
    {
      "name": "database-query-mcp",
      "version": "2.0.1",
      "description": "Query databases with natural language using AI",
      "author": "janedoe",
      "lang": "typescript",
      "license": "Apache-2.0",
      "entrypoint": "index.ts",
      "repository": {
        "type": "git",
        "url": "https://github.com/janedoe/database-query-mcp"
      },
      "tools": {
        "count": 5,
        "names": ["query", "schema", "execute", "explain", "optimize"]
      },
      "pricing": {
        "currency": "INR",
        "amount": 499
      },
      "security_report": {
        "summary": {
          "scan_passed": true,
          "total_issues_all_scanners": 2,
          "critical_issues": 0
        }
      }
    }
  ]
}

{
  "status": "error",
  "detail": "Internal server error"
}

Use Cases

Browse All Servers

const response = await fetch('https://api.superbox.ai/api/v1/servers');
const { servers } = await response.json();

servers.forEach(server => {
  displayServerCard(server);
});

Show Servers by Author

# Get all servers by a specific author
response = requests.get(
    'https://api.superbox.ai/api/v1/servers',
    params={'author': 'areeb'}
)
author_servers = response.json()['servers']

Best Practices

Cache Results

Cache server lists on the client side with an appropriate TTL (5-10 minutes)

Use Author Filter

Use the author query parameter to show a user’s servers on profile pages

Get Server Details

Retrieve detailed information about a specific server

Create Server

Deploy a new MCP server

Getting Started

Core Concepts

Infrastructure

Backend

Frontend

REST API

Servers API

Auth API

CLI

CLI Commands

List Servers

Endpoint

Authentication

Query Parameters

Response

Examples

Response Examples

Use Cases

Best Practices

Cache Results

Use Author Filter

Get Server Details

Create Server

​Endpoint

​Authentication

​Query Parameters

​Response

​Examples

​Response Examples

​Use Cases

​Best Practices

Cache Results

Use Author Filter

​Related Endpoints

Get Server Details

Create Server

Endpoint

Authentication

Query Parameters

Response

Examples

Response Examples

Use Cases

Best Practices

Related Endpoints