---
title: "Update MCP server configuration"
method: PATCH
path: "/api/v3.1/mcp/{id}"
tags: ["MCP", "Servers"]
---

# Update MCP server configuration

`PATCH /api/v3.1/mcp/{id}`

Updates the configuration of an existing Model Control Protocol (MCP) server. You can modify the server name, associated applications, and enabled tools. Only the fields included in the request will be updated.

## Path parameters

- `id` string, required — Unique identifier of the MCP server to retrieve, update, or delete

## Request body

- object — Parameters for updating an existing MCP server configuration
  - `name` string — Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)
  - `toolkits` string[] — List of toolkit slugs this server should be configured to work with.
  - `allowed_tools` string[] — List of action identifiers that should be enabled for this server
  - `managed_auth_via_composio` boolean — Whether the MCP server is managed by Composio
  - `auth_config_ids` string[] — List of auth config IDs to use for this MCP server.

## Response `200`

Successfully updated MCP server. Returns the complete updated server configuration including connection details, authentication settings, and available tools.

- object — MCP server configuration and connection details
  - `id` string, required — UUID of the MCP server instance
  - `name` string, required — User-defined descriptive name for this MCP server
  - `auth_config_ids` string[], required — ID references to the auth configurations used by this server
  - `allowed_tools` string[], required — Array of tool slugs that this MCP server is allowed to use
  - `mcp_url` string, required — [DEPRECATED] Please use the URL with user_id or connected_account_id query param
  - `toolkits` string[], required — Array of toolkit slugs that this MCP server is allowed to use
  - `toolkit_icons` object, required — Object mapping each toolkit slug to its icon/logo URL for display purposes
  - `commands` object, required — Set of command line instructions for connecting various clients to this MCP server
    - `cursor` string, required — Command line instruction for Cursor client setup
    - `claude` string, required — Command line instruction for Claude client setup
    - `windsurf` string, required — Command line instruction for Windsurf client setup
  - `updated_at` string, required — Date and time when this server configuration was last modified
  - `created_at` string, required — Date and time when this server was initially created
  - `server_instance_count` number, required — Total count of active user instances connected to this server
  - `managed_auth_via_composio` boolean, required — Whether the MCP server is managed by Composio
  - `deleted` boolean, required — Whether the MCP server is deleted

## Other responses

- `400` — Bad request. The request parameters may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. The authenticated user does not have permission to update this MCP server.
- `404` — MCP server not found. No server with the specified ID exists or it has been deleted.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)