Get Server

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/servers/:name",
  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/:name"

	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/:name")

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",
  "server": {
    "name": "weather-mcp",
    "version": "1.2.3",
    "description": "Get real-time weather information, forecasts, and location search using the 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": {
      "metadata": {
        "repository": "weather-mcp",
        "repo_url": "https://github.com/areeb/weather-mcp",
        "scan_date": "2025-12-09T08:00:00Z",
        "scanners_used": ["SonarCloud", "Tool Discovery", "Snyk", "GitGuardian", "Bandit"]
      },
      "summary": {
        "total_issues_all_scanners": 0,
        "critical_issues": 0,
        "sonarcloud_url": "https://sonarcloud.io/dashboard?id=weather-mcp",
        "scan_passed": true
      },
      "sonarcloud": {
        "total_issues": 0,
        "bugs": 0,
        "vulnerabilities": 0,
        "code_smells": 0,
        "security_hotspots": 0,
        "quality_gate": "passed",
        "reliability_rating": "A",
        "security_rating": "A",
        "maintainability_rating": "A",
        "coverage": 85.4,
        "duplications": 0.5,
        "lines_of_code": 342
      },
      "gitguardian": {
        "scan_passed": true,
        "total_secrets": 0,
        "secrets": [],
        "error": null
      },
      "bandit": {
        "scan_passed": true,
        "total_issues": 0,
        "severity_counts": {
          "high": 0,
          "medium": 0,
          "low": 0
        },
        "total_lines_scanned": 342,
        "issues": [],
        "error": null
      },
      "recommendations": []
    }
  }
}

{
  "status": "error",
  "detail": "Server not found"
}

GET

servers

:name

Get Server

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/servers/:name",
  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/:name"

	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/:name")

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",
  "server": {
    "name": "weather-mcp",
    "version": "1.2.3",
    "description": "Get real-time weather information, forecasts, and location search using the 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": {
      "metadata": {
        "repository": "weather-mcp",
        "repo_url": "https://github.com/areeb/weather-mcp",
        "scan_date": "2025-12-09T08:00:00Z",
        "scanners_used": ["SonarCloud", "Tool Discovery", "Snyk", "GitGuardian", "Bandit"]
      },
      "summary": {
        "total_issues_all_scanners": 0,
        "critical_issues": 0,
        "sonarcloud_url": "https://sonarcloud.io/dashboard?id=weather-mcp",
        "scan_passed": true
      },
      "sonarcloud": {
        "total_issues": 0,
        "bugs": 0,
        "vulnerabilities": 0,
        "code_smells": 0,
        "security_hotspots": 0,
        "quality_gate": "passed",
        "reliability_rating": "A",
        "security_rating": "A",
        "maintainability_rating": "A",
        "coverage": 85.4,
        "duplications": 0.5,
        "lines_of_code": 342
      },
      "gitguardian": {
        "scan_passed": true,
        "total_secrets": 0,
        "secrets": [],
        "error": null
      },
      "bandit": {
        "scan_passed": true,
        "total_issues": 0,
        "severity_counts": {
          "high": 0,
          "medium": 0,
          "low": 0
        },
        "total_lines_scanned": 342,
        "issues": [],
        "error": null
      },
      "recommendations": []
    }
  }
}

{
  "status": "error",
  "detail": "Server not found"
}

Endpoint

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

Authentication

This endpoint does not require authentication. All server details are publicly accessible.

Path Parameters

string

required

Unique server identifier (lowercase with hyphens). Example: weather-mcp

Response

string

"success" on success, "error" on failure

object

Detailed server information

Show Server Object

string

required

Unique server identifier

string

required

Current semantic version

string

required

Detailed description of the server’s functionality

string

required

Server creator/maintainer name

string

required

Programming language (python, javascript, typescript, go, rust)

string

required

Software license (MIT, Apache-2.0, GPL-3.0, etc.)

string

required

Entry point file for server execution

object

required

Repository information

Show properties

string

Repository type (usually "git")

string

Full repository URL

object

Available tools information

Show properties

integer

Total number of tools provided

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

Comprehensive security scan results

Show properties

object

Scan metadata including repository, repo_url, scan_date, and scanners_used

object

Summary with scan_passed, total_issues_all_scanners, critical_issues, and sonarcloud_url

object

SonarCloud analysis results

object

GitGuardian secrets detection results

object

Bandit security audit results (Python only)

array

Array of security recommendations

Examples

curl -X GET "https://api.superbox.ai/api/v1/servers/weather-mcp"

const serverName = 'weather-mcp';
const response = await fetch(
  `https://api.superbox.ai/api/v1/servers/${serverName}`
);
const { server } = await response.json();

console.log(`${server.name} v${server.version}`);
console.log(`Tools: ${server.tools.names.join(', ')}`);

// Check security status
if (server.security_report?.summary.scan_passed) {
  console.log('Security scan passed');
} else {
  console.warn('Security issues found');
}

import requests

server_name = "weather-mcp"
response = requests.get(
    f"https://api.superbox.ai/api/v1/servers/{server_name}"
)
server = response.json()['server']

print(f"{server['name']} v{server['version']}")
print(f"Author: {server['author']}")
print(f"Language: {server['lang']}")
print(f"Tools: {', '.join(server['tools']['names'])}")

# Check pricing
if server['pricing']['amount'] == 0:
    print("This server is FREE!")
else:
    print(f"Price: {server['pricing']['currency']} {server['pricing']['amount']}")

package main

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

func main() {
serverName := "weather-mcp"
url := fmt.Sprintf("https://api.superbox.ai/api/v1/servers/%s", serverName)

resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()

var result struct {
Status string `json:"status"`
Server struct {
Name    string `json:"name"`
Version string `json:"version"`
Author  string `json:"author"`
} `json:"server"`
}

json.NewDecoder(resp.Body).Decode(&result)

fmt.Printf("%s v%s by %s\n",
result.Server.Name,
result.Server.Version,
result.Server.Author)
}

Response Examples

{
  "status": "success",
  "server": {
    "name": "weather-mcp",
    "version": "1.2.3",
    "description": "Get real-time weather information, forecasts, and location search using the 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": {
      "metadata": {
        "repository": "weather-mcp",
        "repo_url": "https://github.com/areeb/weather-mcp",
        "scan_date": "2025-12-09T08:00:00Z",
        "scanners_used": ["SonarCloud", "Tool Discovery", "Snyk", "GitGuardian", "Bandit"]
      },
      "summary": {
        "total_issues_all_scanners": 0,
        "critical_issues": 0,
        "sonarcloud_url": "https://sonarcloud.io/dashboard?id=weather-mcp",
        "scan_passed": true
      },
      "sonarcloud": {
        "total_issues": 0,
        "bugs": 0,
        "vulnerabilities": 0,
        "code_smells": 0,
        "security_hotspots": 0,
        "quality_gate": "passed",
        "reliability_rating": "A",
        "security_rating": "A",
        "maintainability_rating": "A",
        "coverage": 85.4,
        "duplications": 0.5,
        "lines_of_code": 342
      },
      "gitguardian": {
        "scan_passed": true,
        "total_secrets": 0,
        "secrets": [],
        "error": null
      },
      "bandit": {
        "scan_passed": true,
        "total_issues": 0,
        "severity_counts": {
          "high": 0,
          "medium": 0,
          "low": 0
        },
        "total_lines_scanned": 342,
        "issues": [],
        "error": null
      },
      "recommendations": []
    }
  }
}

{
  "status": "error",
  "detail": "Server not found"
}

Use Cases

Display Server Details

async function displayServerPage(serverName) {
  const response = await fetch(
    `https://api.superbox.ai/api/v1/servers/${serverName}`
  );
  const { server } = await response.json();

  document.getElementById('name').textContent = server.name;
  document.getElementById('version').textContent = server.version;
  document.getElementById('description').textContent = server.description;
  document.getElementById('tools').innerHTML =
    server.tools.names.map(tool => `<li>${tool}</li>`).join('');
}

Check Security Status

def is_server_secure(server_name):
    response = requests.get(
        f'https://api.superbox.ai/api/v1/servers/{server_name}'
    )
    server = response.json()['server']

    security = server.get('security_report', {}).get('summary', {})
    return security.get('scan_passed', False) and \
           security.get('critical_issues', 1) == 0

if is_server_secure('weather-mcp'):
    print("Server is secure")
else:
    print("Security concerns found")

List Servers

Browse all available MCP servers

Create Server

Deploy a new MCP server

Getting Started

Core Concepts

Infrastructure

Backend

Frontend

REST API

Servers API

Auth API

CLI

CLI Commands

Get Server

Endpoint

Authentication

Path Parameters

Response

Examples

Response Examples

Use Cases

List Servers

Create Server

​Endpoint

​Authentication

​Path Parameters

​Response

​Examples

​Response Examples

​Use Cases

​Related Endpoints

List Servers

Create Server

Endpoint

Authentication

Path Parameters

Response

Examples

Response Examples

Use Cases

Related Endpoints