API ReferenceMCP

Update MCP server configuration

Markdown
PATCH/api/v3/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.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

idstringRequired

The ID of the MCP server

Request Body

application/json

namestring

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

toolkitsarray of string

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

allowed_toolsarray of string

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_idsarray of string

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://backend.composio.dev/api/v3/mcp/550e8400-e29b-41d4-a716-446655440000" \  -H "Content-Type: application/json" \  -d '{    "name": "Updated GitHub Integration Server"  }'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "GitHub Integration Server",
  "auth_config_ids": [
    "auth_cfg_abc123def456",
    "auth_cfg_xyz789"
  ],
  "allowed_tools": [
    "github-issues",
    "github-repos",
    "github-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,
  "deleted": true
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}