MCP

Update MCP server configuration

Changed on

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.

patch/api/v3.1/mcp/{id}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/mcp/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

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

Example:550e8400-e29b-41d4-a716-446655440000

The ID of the MCP server

Request body

namestring

Human-readable name to identify this MCP server instance (4-30 characters, alphanumeric, spaces, and hyphens only)

toolkitsstring[]

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

allowed_toolsstring[]

List of action identifiers that should be enabled for this server

managed_auth_via_composioboolean

Whether the MCP server is managed by Composio

auth_config_idsstring[]

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

Example request

{
  "name": "Production GitHub Integration",
  "toolkits": [
    "gmail",
    "notion"
  ],
  "allowed_tools": [
    "GMAIL_ADD_LABEL_TO_EMAIL"
  ],
  "managed_auth_via_composio": true,
  "auth_config_ids": [
    "ac_1a2b3c4d5e6f",
    "ac_7g8h9i0j1k2l"
  ]
}

Response

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

idstring required

UUID of the MCP server instance

namestring required

User-defined descriptive name for this MCP server

auth_config_idsstring[] required

ID references to the auth configurations used by this server

allowed_toolsstring[] required

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

mcp_urlstring required

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

toolkitsstring[] required

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

toolkit_iconsobject required

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

updated_atstring required

Date and time when this server configuration was last modified

created_atstring required

Date and time when this server was initially created

server_instance_countnumber required

Total count of active user instances connected to this server

managed_auth_via_composioboolean required

Whether the MCP server is managed by Composio

deletedboolean required

Whether the MCP server is deleted

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "GitHub Integration Server",
  "auth_config_ids": [
    "ac_1a2b3c4d5e6f",
    "ac_7g8h9i0j1k2l"
  ],
  "allowed_tools": [
    "GITHUB_CREATE_AN_ISSUE",
    "GITHUB_GET_A_REPOSITORY",
    "GITHUB_LIST_PULL_REQUESTS"
  ],
  "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john",
  "toolkits": [
    "github",
    "jira",
    "slack"
  ],
  "toolkit_icons": {
    "github": "https://assets.composio.dev/logos/github.png",
    "jira": "https://assets.composio.dev/logos/jira.png",
    "slack": "https://assets.composio.dev/logos/slack.png"
  },
  "commands": {
    "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",
    "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude",
    "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"
  },
  "updated_at": "2023-06-15T14:30:00.000Z",
  "created_at": "2023-06-10T09:15:00.000Z",
  "server_instance_count": 5,
  "managed_auth_via_composio": true
}

Changes

  • 98956f31abf3Revision changes
    • info

      api operation id patchV3_1McpById removed and replaced with patchMcpById

    • info

      api tag Servers removed

    • info

      endpoint deprecated

  • 589a7d115a5eRevision changes
    • info

      the endpoint scheme security CookieAuth was removed from the API

    • info

      the endpoint scheme security UserApiKeyAuth was removed from the API