List Servers

Retrieve a list of all available MCP servers with optional filtering

GET /servers

List Servers

cURL

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

200 Success

{
  "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
        }
      }
    }
  ]
}

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

author · string

Filter servers by author/creator username

Response

status · string

"success" on success, "error" on failure

total · integer

Total number of servers returned

servers · array

Array of server objects

Show Server Object

name · string · required

Unique server identifier (lowercase with hyphens)

version · string · required

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

description · string · required

Brief description of the server’s functionality

author · string · required

Server creator/maintainer name

lang · string · required

Programming language

license · string · required

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

entrypoint · string · required

Entry point file for server execution

repository · object · required

Repository information

Show properties

type · string

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

url · string

Repository URL

tools · object

Available tools information

Show properties

count · integer

Number of tools provided by the server

names · array

Array of tool names

pricing · object · required

Pricing information

Show properties

currency · string

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

amount · number

Price amount (0 for free servers)

security_report · object

Security scan summary

Show properties

summary.scan_passed · boolean

Whether the server passed security scans

summary.total_issues_all_scanners · integer

Total number of issues found across all scanners

summary.critical_issues · integer

Number of critical security issues

Examples

cURL

# 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"

Response Examples

200 Success

{
  "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
        }
      }
    }
  ]
}

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

Related Endpoints

Get Server Details

Retrieve detailed information about a specific server

Create Server

Deploy a new MCP server