API Reference

// Using fetch API
const API_KEY = 'mcp_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const BASE_URL = 'https://api.mcpsafe.com';

// List servers
const listServers = async () => {
  const response = await fetch(`${BASE_URL}/api/v1/servers?page=1&limit=10`);
  return response.json();
};

// Get server details
const getServer = async (slug) => {
  const response = await fetch(`${BASE_URL}/api/v1/servers/${slug}`);
  return response.json();
};

// Submit URL for scanning
const scanUrl = async (url) => {
  const response = await fetch(`${BASE_URL}/api/v1/scans/url`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY,
    },
    body: JSON.stringify({ url }),
  });
  return response.json();
};

// Check scan status
const getScanStatus = async (scanId) => {
  const response = await fetch(`${BASE_URL}/api/v1/scans/${scanId}`, {
    headers: { 'X-API-Key': API_KEY },
  });
  return response.json();
};

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "filesystem-mcp",
    "slug": "npm-filesystem-mcp",
    "sourceType": "npm",
    "description": "A file system MCP server for local operations",
    "category": "file-system",
    "language": "typescript",
    "stars": 1250,
    "downloads": 45000,
    "status": "verified",
    "security": {
      "score": 92,
      "grade": "A",
      "vulnerabilities": {
        "critical": 0,
        "high": 0,
        "medium": 2,
        "low": 3,
        "total": 5
      }
    },
    "quality": {
      "score": 88,
      "grade": "A",
      "breakdown": {
        "maintenance": 90,
        "popularity": 85,
        "documentation": 92,
        "compatibility": 85
      }
    }
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-18T10:30:00.000Z"
  }
}