v43

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0163155274.5 KB
registry-servers

List available registry servers

Get a paginated list of servers from the registry. Supports optional full-text search and pagination.

get/registry/{registryName}/v0.1/servers

Path parameters

registryNamestring required

Registry name (currently ignored, uses the default provider)

Query parameters

qstring

Search filter — matches against server name and description

pageinteger

Page number, 1-based (default: 1)

limitinteger

Items per page, max 200 (default: 50)

Response

OK

Example response

{
  "servers": [
    {
      "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
      "description": "MCP server providing weather data and forecasts via OpenWeatherMap API",
      "icons": [
        {
          "mimeType": "image/png",
          "src": "https://example.com/icon.png"
        }
      ],
      "name": "io.github.user/weather",
      "packages": [
        {
          "environmentVariables": [
            {
              "name": "SOME_VARIABLE"
            }
          ],
          "fileSha256": "fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce",
          "identifier": "@modelcontextprotocol/server-brave-search",
          "packageArguments": [
            {
              "name": "--port",
              "type": "positional",
              "valueHint": "file_path"
            }
          ],
          "registryBaseUrl": "https://registry.npmjs.org",
          "registryType": "npm",
          "runtimeArguments": [
            {
              "name": "--port",
              "type": "positional",
              "valueHint": "file_path"
            }
          ],
          "runtimeHint": "npx",
          "transport": {
            "headers": [
              {
                "name": "SOME_VARIABLE"
              }
            ],
            "type": "stdio",
            "url": "https://api.example.com/mcp"
          },
          "version": "1.0.2"
        }
      ],
      "remotes": [
        {
          "headers": [
            {
              "name": "SOME_VARIABLE"
            }
          ],
          "type": "stdio",
          "url": "https://api.example.com/mcp"
        }
      ],
      "repository": {
        "id": "b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9",
        "source": "github",
        "subfolder": "src/everything",
        "url": "https://github.com/modelcontextprotocol/servers"
      },
      "title": "Weather API",
      "version": "1.0.2",
      "websiteUrl": "https://modelcontextprotocol.io/examples"
    }
  ]
}