Skip to main content
PATCH

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

id
string
required

The ID of the MCP server Unique identifier of the MCP server to retrieve, update, or delete

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

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)

Example:

"Production GitHub Integration"

toolkits
string[]

List of toolkit slugs this server should be configured to work with.

Example:
allowed_tools
string[]

List of action identifiers that should be enabled for this server

Example:
managed_auth_via_composio
boolean

Whether the MCP server is managed by Composio

Example:

true

auth_config_ids
string[]

List of auth config IDs to use for this MCP server.

Example:

Response

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

MCP server configuration and connection details

id
string
required

UUID of the MCP server instance

Example:

"550e8400-e29b-41d4-a716-446655440000"

name
string
required

User-defined descriptive name for this MCP server

Example:

"GitHub Integration Server"

auth_config_ids
string[]
required

ID references to the auth configurations used by this server

Example:
allowed_tools
string[]
required

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

Example:
mcp_url
string
required
deprecated

[DEPRECATED] Please use the URL with user_id or connected_account_id query param

Example:

"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"

toolkits
string[]
required

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

Example:
toolkit_icons
object
required

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

Example:
commands
object
required
deprecated

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

updated_at
string
required

Date and time when this server configuration was last modified

Example:

"2023-06-15T14:30:00.000Z"

created_at
string
required

Date and time when this server was initially created

Example:

"2023-06-10T09:15:00.000Z"

server_instance_count
number
required

Total count of active user instances connected to this server

Example:

5

managed_auth_via_composio
boolean
required

Whether the MCP server is managed by Composio

Example:

true

deleted
boolean
required

Whether the MCP server is deleted