Update MCP server configuration

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

idstringRequired

The ID of the MCP server

Request

This endpoint expects an object.

namestringOptional

Human-readable name to identify this MCP server

appslist of stringsOptional

List of application identifiers this server should be configured to work with

actionslist of stringsOptional

List of action identifiers that should be enabled for this server

Response

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

idstring

UUID of the MCP server instance

namestring

User-defined descriptive name for this MCP server

auth_config_idstring

ID reference to the auth configuration used by this server

allowed_toolslist of strings

Array of tool slugs that this MCP server is allowed to use

mcp_urlstring

URL endpoint for establishing SSE connection to this MCP server

commandsobject

Set of command line instructions for connecting various clients to this MCP server

updated_atstring

ISO timestamp of when this server configuration was last modified

created_atstring

ISO timestamp of when this server was initially created

client_idstring

Project identifier that owns this MCP server instance

deletedboolean

Flag indicating if this server has been soft-deleted

actionsobjectOptional

Dictionary of action configurations and permissions available for this MCP server

entity_idslist of stringsOptional

List of entity identifiers this MCP server can interact with

appslist of stringsOptional

List of application identifiers this server is configured to work with

custom_auth_headersbooleanOptional

Flag indicating if this server uses custom authentication headers

connected_account_idslist of stringsOptional

List of connected account identifiers this server can use for authentication

auth_configslist of stringsOptional

List of authentication configuration identifiers used by this server

1	curl -X PATCH https://backend.composio.dev/api/v3/mcp/ \
2	-H "x-api-key: <x-api-key>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Updated GitHub Integration Server"
6	}'

1	{
2	"id": "550e8400-e29b-41d4-a716-446655440000",
3	"name": "GitHub Integration Server",
4	"auth_config_id": "auth_cfg_abc123def456",
5	"allowed_tools": [
6	"foo"
7	],
8	"mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?transport=sse",
9	"commands": {
10	"cursor": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client cursor",
11	"claude": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client claude",
12	"windsurf": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client windsurf"
13	},
14	"updated_at": "2023-06-15T14:30:00.000Z",
15	"created_at": "2023-06-10T09:15:00.000Z",
16	"client_id": "proj_a1b2c3d4e5f6",
17	"deleted": false,
18	"actions": {},
19	"entity_ids": [
20	"foo"
21	],
22	"apps": [
23	"foo"
24	],
25	"custom_auth_headers": true,
26	"connected_account_ids": [
27	"foo"
28	],
29	"auth_configs": [
30	"foo"
31	]
32	}

Path parameters

Headers

Request

Response