---
title: "Update an MCP server"
method: PUT
path: "/v1/redpanda-connect/mcp-servers/{id}"
tags: ["Remote MCP"]
---

# Update an MCP server

`PUT /v1/redpanda-connect/mcp-servers/{id}`

Update the configuration of an MCP server.

## Path parameters

- `id` string, required

## Query parameters

- `update_mask` string

## Request body

- MCPServerUpdate
  - `description` string — MCP server description.
  - `display_name` string — User-friendly MCP server name.
  - `resources` Resources
    - `cpu_shares` string, required — `cpu_shares` is a string specifying the amount of CPU to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "m" (e.g., "500m" for 500 millicores, "2" for 2 cores) CPU shares can be specified in millicores (1 core = 1000 millicores). If you don't specify a unit, the value is interpreted as the number of cores.
    - `memory_shares` string, required — `memory_shares` is a string specifying the amount of memory to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "K", "M", "G", "T", "P", "E" (e.g., "128M" for 128 megabytes) - Binary SI units: "Ki", "Mi", "Gi", "Ti", "Pi", "Ei" (e.g., "512Mi" for 512 mebibytes) If you don't specify a unit, the value is interpreted as bytes.
  - `service_account` MCPServerServiceAccount
    - `client_id` string, required
    - `client_secret` string, required
  - `tags` object — A map of tags to add, update or delete. If a tag's value is empty, the server interprets that as a deletion.
  - `tools` object — Map of tool names to their configurations. Each tool defines a capability that the MCP server exposes.

## Response `200`

OK

- MCPServer — Defines the MCP server resource.
  - `description` string — Optional MCP server description.
  - `display_name` string, required — User-friendly MCP server name.
  - `id` string, required — Unique identifier for the MCP server.
  - `resources` Resources
    - `cpu_shares` string, required — `cpu_shares` is a string specifying the amount of CPU to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "m" (e.g., "500m" for 500 millicores, "2" for 2 cores) CPU shares can be specified in millicores (1 core = 1000 millicores). If you don't specify a unit, the value is interpreted as the number of cores.
    - `memory_shares` string, required — `memory_shares` is a string specifying the amount of memory to allocate for the pipeline. This follows the [Kubernetes quantity](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/quantity/) format. Acceptable units include: - Decimal SI units: "K", "M", "G", "T", "P", "E" (e.g., "128M" for 128 megabytes) - Binary SI units: "Ki", "Mi", "Gi", "Ti", "Pi", "Ei" (e.g., "512Mi" for 512 mebibytes) If you don't specify a unit, the value is interpreted as bytes.
  - `service_account` MCPServerServiceAccount, required
    - `client_id` string, required
    - `client_secret` string, required
  - `state` 'STATE_STARTING' | 'STATE_RUNNING' | 'STATE_STOPPING' | 'STATE_STOPPED' | 'STATE_ERROR' — State of the MCP server. - STATE_STARTING: The MCP server is starting. - STATE_RUNNING: The MCP server is running. - STATE_STOPPING: The MCP server is in the process of stopping. - STATE_STOPPED: The MCP server is stopped and in paused state. - STATE_ERROR: The MCP server encountered an error.
  - `status` MCPServerStatus — MCP server status may contain an error message.
    - `error` string — Error message if the MCP server is in an error state. Empty if no error.
  - `tags` object — Tags are key-value pairs that can be assigned to an MCP server resource. They help organize MCP servers and enable filtering when listing them.
  - `tools` object, required — Map of tool names to their configurations. Each tool defines a capability that the MCP server exposes.
  - `url` string — URL to connect to the MCP server.

## Other responses

- `401` — Unauthenticated.
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

## Changes

- **2025-12-16** `1a5d7b6e5762` — 2 info
  - api tag `Remote MCP` added
  - api tag `Redpanda Connect MCP servers` removed
- **2025-11-25** `87688d3474c2` — 1 info
  - endpoint added
- **2025-08-12** `13b59123fea0` — 1 breaking
  - api path removed without deprecation
- **2025-08-12** `d7649071e8e1` — 1 breaking, 1 warning, 2 info
  - removed the required property `config_files` from the response with the `200` status
  - removed the request property `config_files`
  - added the new optional request property `tools`
  - added the required property `tools` to the response with the `200` status
- **2025-06-26** `a797fd06fd45` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/changes/v1/redpanda-connect/mcp-servers/:id/put.md)

---

[API](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.dev/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/revisions/7eef0bcc42e7/schema)