Skip to main content
GET
/
servers
/
:name
Get Server
curl --request GET \
  --url https://api.example.com/servers/:name
{
  "success": true,
  "data": {
    "name": "weather-mcp",
    "version": "1.2.3",
    "description": "Get real-time weather information, forecasts, and location search using the OpenWeatherMap API. Supports temperature, humidity, wind speed, and 5-day forecasts.",
    "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": "USD",
      "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", "GitGuardian", "Bandit"]
      },
      "summary": {
        "total_issues_all_scanners": 0,
        "critical_issues": 0,
        "sonarcloud_url": "https://sonarcloud.io/dashboard?id=weather-mcp",
        "scan_passed": true
      },
      "sonarqube": {
        "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": []
    }
  },
  "meta": {
    "timestamp": "2025-12-09T10:30:00Z",
    "version": "v1"
  }
}

​
Endpoint

​
Authentication

This endpoint works with or without authentication.
Authenticated requests have access to additional details and higher rate limits

​
Path Parameters

​
name
string
required
Unique server identifier (lowercase with hyphens) Example: weather-mcp, database-query-mcp

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
Detailed server information
​
meta
object
Response metadata

​
Examples

cURL
# Get server details
curl -X GET "https://api.superbox.ai/api/v1/servers/weather-mcp" \
  -H "Content-Type: application/json"

# With authentication for additional details

curl -X GET "https://api.superbox.ai/api/v1/servers/weather-mcp" \
 -H "Authorization: Bearer $SUPERBOX_API_TOKEN" \
 -H "Content-Type: application/json"

​
Response Examples

{
  "success": true,
  "data": {
    "name": "weather-mcp",
    "version": "1.2.3",
    "description": "Get real-time weather information, forecasts, and location search using the OpenWeatherMap API. Supports temperature, humidity, wind speed, and 5-day forecasts.",
    "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": "USD",
      "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", "GitGuardian", "Bandit"]
      },
      "summary": {
        "total_issues_all_scanners": 0,
        "critical_issues": 0,
        "sonarcloud_url": "https://sonarcloud.io/dashboard?id=weather-mcp",
        "scan_passed": true
      },
      "sonarqube": {
        "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": []
    }
  },
  "meta": {
    "timestamp": "2025-12-09T10:30:00Z",
    "version": "v1"
  }
}

​
Use Cases

async function displayServerPage(serverName) {
  const response = await fetch(
    `https://api.superbox.ai/api/v1/servers/${serverName}`
  );
  const { data: server } = await response.json();
  
  // Render server details in UI
  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('');
}

def is_server_secure(server_name):
    response = requests.get(
        f'https://api.superbox.ai/api/v1/servers/{server_name}'
    )
    server = response.json()['data']
    
    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")

async function validateBeforePurchase(serverName) {
  const response = await fetch(
    `https://api.superbox.ai/api/v1/servers/${serverName}`
  );
  const { data: server } = await response.json();
  
  // Check if paid
  if (server.pricing.amount > 0) {
    // Check security
    if (!server.security_report?.summary.scan_passed) {
      alert('Warning: This server has security issues');
      return false;
    }
    
    // Show pricing
    const confirmed = confirm(
      `Purchase ${server.name} for ${server.pricing.currency} ${server.pricing.amount}?`
    );
    return confirmed;
  }
  
  return true; // Free server
}

# Get repository URL and clone
REPO_URL=$(curl -s "https://api.superbox.ai/api/v1/servers/weather-mcp" | \
  jq -r '.data.repository.url')

git clone $REPO_URL

​
Understanding Security Reports

The security_report object provides comprehensive security analysis:
Code Quality Analysis - Bugs: Actual coding errors - Vulnerabilities: Security vulnerabilities - Code Smells: Maintainability issues - Coverage: Test coverage percentage - Quality Gate: Overall pass/fail status Ratings (A-E): - A: Excellent - B: Good
  • C: Acceptable - D: Poor - E: Critical issues

​
Best Practices

Cache Details

Cache server details with a 10-15 minute TTL to reduce API calls

Check Security

Always validate security scan status before deploying or purchasing

Handle 404s

Gracefully handle cases where servers don’t exist

Display Tools

Show available tools to help users understand server capabilities

List Servers

Browse all available servers

Create Server

Deploy a new server

Update Server

Modify server metadata