servers

Update MCP server status

Update the status metadata of a specific version of an MCP server. Requires publish or edit permission for the server. This endpoint allows changing status and status message without requiring the full server configuration.

patch/v0/servers/{serverName}/versions/{version}/status

Request

  • Base URL: https://registry.modelcontextprotocol.io (the document declares no server; this is the origin it was published from)
  • URL: https://registry.modelcontextprotocol.io/v0/servers/{serverName}/versions/{version}/status
  • Auth: bearer (a scheme the document does not define)

Path parameters

serverNamestring required

URL-encoded server name

Example:com.example%2Fmy-server
versionstring required

URL-encoded version to update

Example:1.0.0

Headers

Authorizationstring required

Registry JWT token with publish or edit permissions

Request body

status'active' | 'deprecated' | 'deleted' required

New server lifecycle status

statusMessagestring

Optional message explaining the status change (e.g., reason for deprecation)

Response

OK

Example response

{
  "server": {
    "$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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.