MCPSafe
DocsAPI ReferenceServers API
Servers API

Servers API

Access the MCPSafe server registry to list, search, and get detailed information about MCP servers.

Endpoints

GET
/api/v1/servers

List all servers in the registry

Parameters

page
number
Page number (default: 1)
limit
number
Results per page (default: 20, max: 100)
category
string
Filter by category slug
search
string
Search by name or description
sort
string
Sort field: name, score, created (default: score)
order
string
Sort order: asc, desc (default: desc)
GET
/api/v1/servers/:slug

Get detailed information about a specific server

Parameters

slug
string
Server slug (path parameter)
GET
/api/v1/servers/:slug/vulnerabilities

Get vulnerabilities for a specific server

Parameters

slug
string
Server slug (path parameter)
severity
string
Filter by severity: critical, high, medium, low, info
GET
/api/v1/servers/:slug/history

Get scan history for a specific server

Parameters

slug
string
Server slug (path parameter)
limit
number
Number of history entries (default: 10)

Examples

Request

List all servers
curl https://api.mcpsafe.org/api/v1/servers?page=1&limit=20 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK
{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "srv_abc123",
        "name": "filesystem-server",
        "slug": "filesystem-server",
        "description": "MCP server for file system operations",
        "category": "file-management",
        "repositoryUrl": "https://github.com/modelcontextprotocol/servers",
        "npmPackage": "@modelcontextprotocol/server-filesystem",
        "securityScore": 85,
        "grade": "A",
        "lastScannedAt": "2024-01-15T10:30:00Z",
        "vulnerabilities": {
          "critical": 0,
          "high": 0,
          "medium": 1,
          "low": 2,
          "info": 3
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 156,
      "totalPages": 8
    }
  }
}

Response Fields

securityScoreNumeric score from 0-100 based on vulnerability findings
gradeLetter grade (A+ to F) derived from security score
qualityMetricsObject containing maintenance, popularity, documentation, and compatibility scores
vulnerabilitiesCount of vulnerabilities grouped by severity level
lastScannedAtISO 8601 timestamp of the most recent security scan