---
title: "Update Mcp Server"
method: PATCH
path: "/v1/mcp-servers/{server_id}"
tags: ["v1", "protected", "mcp-servers"]
---

# Update Mcp Server

`PATCH /v1/mcp-servers/{server_id}`

## Path parameters

- `server_id` string, uuid, required

## Request body

- MCPServerUpdate
  - `cmd` string[], nullable — Custom command to override container CMD
  - `description` string, nullable — Description of the MCP server
  - `docker_image_url` string, nullable — Docker image URL
  - `is_public` boolean, nullable — Whether the server is public
  - `name` string, nullable — Name of the MCP server
  - `status` string, nullable — Status of the MCP server
  - `tags` string[], nullable — Tags for categorization
  - `version` string, nullable — Version of the MCP server

## Response `200`

Successful Response

- MCPServerResponse
  - `cmd` string[], nullable, required
  - `created_at` string, date-time, required
  - `description` string, required
  - `docker_image_url` string, required
  - `env_schema` object[], required
  - `id` string, uuid, required
  - `is_public` boolean, required
  - `name` string, required
  - `status` string, required
  - `tags` string[], required
  - `updated_at` string, date-time, required
  - `version` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-30** `e9c153221160` — 2 breaking, 7 warning, 3 info
  - for the `path` request parameter `server_id`, the format changed from no format to `uuid`
  - removed the required property `slug` from the response with the `200` status
  - removed the request property `env_schema`
  - removed the request property `json_spec`
  - …8 more

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/mcp-servers/:server_id/patch.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/e9c153221160/schema)