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

id*string

The ID of the MCP server

Request Body

application/json

name?string

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

toolkits?array<string>

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

allowed_tools?array<string>

List of action identifiers that should be enabled for this server

managed_auth_via_composio?boolean

Whether the MCP server is managed by Composio

auth_config_ids?array<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"
    ]
  }
}