Skip to main content

API Documentation

MCPSERVER.WORK provides a simple REST API that allows AI systems and developers to access MCP servers and clients data in a structured format. The API is designed with AI systems in mind, offering clear and consistent data structures.

Interactive API Documentation​

This interactive documentation lets you explore and test the API endpoints directly in your browser.

API Endpoints​

All API endpoints support CORS, allowing access from any domain. The data is returned in JSON format and is sorted alphabetically by name by default.

Servers API​

Get a list of all MCP servers or filter by category.

Get All Servers​

GET /api/v1/servers.json

Example Response:

{
  "meta": {
    "version": "1.0.0",
    "lastUpdated": "2025-04-04T10:33:00-04:00",
    "totalCount": 32
  },
  "categories": [
    "file-systems",
    "databases",
    "web-browser-automation",
    "developer-tools",
    "cloud-platforms",
    "communication",
    "knowledge-memory",
    "search",
    "location-services",
    "finance-cryptocurrency",
    "version-control",
    "security",
    "art-culture",
    "command-line",
    "monitoring",
    "marketing",
    "gaming",
    "data-science",
    "other-tools"
  ],
  "servers": [
    {
      "id": "filesystem",
      "name": "Filesystem",
      "repo": "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
      "description": "Direct local file system access with configurable permissions",
      "category": "file-systems",
      "languages": ["python"],
      "official": true,
      "platforms": ["windows", "macos", "linux"]
    },
    // Other servers...
  ]
}

Get Servers by Category​

GET /api/v1/servers.json?category=file-systems

Query Parameters:

  • category (optional): Filter servers by category (e.g., "file-systems", "databases", etc.)
  • language (optional): Filter by programming language (e.g., "python", "typescript", etc.)
  • platform (optional): Filter by platform (e.g., "windows", "macos", "linux", "cross-platform", "cloud")
  • official (optional): Filter by official implementation ("true" or "false")

Clients API​

Get a list of all MCP clients or filter by type.

Get All Clients​

GET /api/v1/clients.json

Example Response:

{
  "meta": {
    "version": "1.0.0",
    "lastUpdated": "2025-04-04T10:34:00-04:00",
    "totalCount": 28
  },
  "types": [
    "desktop-applications",
    "ide-extensions",
    "cli-tools",
    "web-applications",
    "mobile-applications",
    "development-libraries"
  ],
  "clients": [
    {
      "id": "claude-desktop",
      "name": "Claude Desktop",
      "website": "https://claude.ai/download",
      "description": "The official Claude desktop application with MCP support for tool use",
      "type": "desktop-applications",
      "license": "Proprietary",
      "platforms": ["windows", "macos"],
      "pricing": "Free"
    },
    // Other clients...
  ]
}

Get Clients by Type​

GET /api/v1/clients.json?type=desktop-applications

Query Parameters:

  • type (optional): Filter clients by type (e.g., "desktop-applications", "ide-extensions", etc.)
  • platform (optional): Filter by platform (e.g., "windows", "macos", "linux", "vs-code", etc.)
  • license (optional): Filter by license type (e.g., "MIT", "Apache 2.0", "Proprietary", etc.)
  • pricing (optional): Filter by pricing model (e.g., "Free", "Freemium", "Paid", etc.)

Data Structure​

Server Data Structure​

Each server object contains the following fields:

  • id: Unique identifier
  • name: Server name
  • repo: GitHub repository link
  • description: Description of functionality
  • category: Category it belongs to
  • languages: Array of programming languages
  • official: Whether it's an official implementation
  • platforms: Array of supported platforms

Client Data Structure​

Each client object contains the following fields:

  • id: Unique identifier
  • name: Client name
  • repo: GitHub repository link (if available)
  • website: Official website (if available)
  • description: Description of functionality
  • type: Client type
  • license: License type
  • platforms: Array of supported platforms
  • pricing: Pricing information

Usage Notes​

  • The API endpoints are designed to be simple and straightforward for AI systems to use
  • All data is provided in a structured JSON format
  • No authentication or API key is required
  • Rate limiting is set to 60 requests per minute per IP
  • Data is updated weekly or when new submissions are made
{
  "@context": "https://schema.org",
  "@type": "WebAPI",
  "name": "MCPSERVER.WORK API",
  "description": "A REST API providing structured data for MCP servers and clients",
  "documentation": "https://mcpserver.work/api-documentation",
  "url": "https://mcpserver.work/api/v1/servers.json",
  "serviceType": "REST API",
  "provider": {
    "@type": "Organization",
    "name": "MCPSERVER.WORK"
  }
}