---
title: "Update status for all server versions"
method: PATCH
path: "/v0.1/servers/{serverName}/status"
tags: ["publish"]
---

# Update status for all server versions

`PATCH /v0.1/servers/{serverName}/status`

Update the lifecycle status of all versions of a server in a single transaction.
Either all versions are updated or none on failure.

Requires `publish` or `edit` permission for the server namespace.

## Path parameters

- `serverName` string, required

## Request body

- StatusUpdateRequest — Request body for updating server status
  - `status` 'active' | 'deprecated' | 'deleted', required — New server lifecycle status
  - `statusMessage` string — Optional message explaining the status change (e.g., deprecation reason)

## Response `200`

Successfully updated all versions

- AllVersionsStatusResponse — Response from bulk status update for all versions
  - `updatedCount` integer, required — Number of versions updated
  - `servers` ServerResponse[], required — List of all updated server versions
    - `server` ServerDetail, required — unresolved $ref
    - `_meta` object — Registry-managed metadata
      - `io.modelcontextprotocol.registry/official` object — Official MCP registry metadata
        - `status` 'active' | 'deprecated' | 'deleted' — Server lifecycle status
        - `statusMessage` string — Optional message explaining the status (e.g., deprecation reason)
        - `statusChangedAt` string, date-time — Timestamp when the server status was last updated
        - `publishedAt` string, date-time — Timestamp when the server was first published to the registry
        - `updatedAt` string, date-time — Timestamp when the server entry was last updated
        - `isLatest` boolean — Whether this is the latest version of the server

## Other responses

- `400` — Bad request - Invalid status value
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - Insufficient permissions
- `404` — Server not found

## Changes

- **2026-04-23** `71ff271089a8` — 1 info
  - added the optional property `servers/items/_meta/io.modelcontextprotocol.registry/official/statusChangedAt` to the response with the `200` status
- **2026-02-27** `d996fbd54ad7` — 1 info
  - endpoint added
- **2025-09-07** `90e6adac431e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/modelcontextprotocol/apis/mcp-server-registry-api/changes/v0.1/servers/:serverName/status/patch.md)

---

[API](https://skmtc.dev/modelcontextprotocol/apis/mcp-server-registry-api.md) · [All operations](https://skmtc.dev/modelcontextprotocol/apis/mcp-server-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modelcontextprotocol/mcp-server-registry-api/revisions/3ed9ca429754/schema)