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 instance (4-30 characters, alphanumeric, spaces, and hyphens only)

toolkitslist of stringsOptional

List of toolkit slugs this server should be configured to work with. Must have the same count and order as auth_config_ids.

allowed_toolslist of stringsOptional

List of action identifiers that should be enabled for this server

managed_auth_via_composiobooleanOptional

Whether the MCP server is managed by Composio

auth_config_idslist of stringsOptional

List of auth config IDs to use for this MCP server. Can include multiple different toolkits.

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_idslist of strings

ID references to the auth configurations 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

toolkitslist of strings

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

toolkit_iconsmap from strings to strings

Object mapping each toolkit slug to its icon/logo URL for display purposes

commandsobject

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

updated_atstring

Date and time when this server configuration was last modified

created_atstring

Date and time when this server was initially created

server_instance_countdouble

Total count of active user instances connected to this server

managed_auth_via_composioboolean

Whether the MCP server is managed by Composio

deletedboolean

Whether the MCP server is deleted

1	from composio_client import Composio
2
3	client = Composio(
4	api_key="My API Key",
5	)
6	mcp = client.mcp.update(
7	id="550e8400-e29b-41d4-a716-446655440000",
8	name="Updated GitHub Integration Server",
9	)
10	print(mcp.id)

1	{
2	"id": "550e8400-e29b-41d4-a716-446655440000",
3	"name": "GitHub Integration Server",
4	"auth_config_ids": [
5	"auth_cfg_abc123def456",
6	"auth_cfg_xyz789"
7	],
8	"allowed_tools": [
9	"github-issues",
10	"github-repos",
11	"github-pull-requests"
12	],
13	"mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?transport=sse",
14	"toolkits": [
15	"github",
16	"jira",
17	"slack"
18	],
19	"toolkit_icons": {
20	"github": "https://assets.composio.dev/logos/github.png",
21	"jira": "https://assets.composio.dev/logos/jira.png",
22	"slack": "https://assets.composio.dev/logos/slack.png"
23	},
24	"commands": {
25	"cursor": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client cursor",
26	"claude": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client claude",
27	"windsurf": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client windsurf"
28	},
29	"updated_at": "2023-06-15T14:30:00.000Z",
30	"created_at": "2023-06-10T09:15:00.000Z",
31	"server_instance_count": 5,
32	"managed_auth_via_composio": true,
33	"deleted": true
34	}

Update MCP server configuration

Path parameters

Headers

Request

Response

Errors