> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /api-reference/openapi-v3.json patch /api/v3/mcp/{id}
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/mcp/{id}:
    patch:
      tags:
        - MCP
      summary: Update MCP server configuration
      description: >-
        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.
      operationId: patchMcpById
      parameters:
        - schema:
            type: string
            description: Unique identifier of the MCP server to retrieve, update, or delete
            example: 550e8400-e29b-41d4-a716-446655440000
          required: true
          description: The ID of the MCP server
          name: id
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    Human-readable name to identify this MCP server instance
                    (4-30 characters, alphanumeric, spaces, and hyphens only)
                  example: Production GitHub Integration
                toolkits:
                  type: array
                  items:
                    type: string
                  description: >-
                    List of toolkit slugs this server should be configured to
                    work with.
                  example:
                    - gmail
                    - notion
                allowed_tools:
                  type: array
                  items:
                    type: string
                  description: >-
                    List of action identifiers that should be enabled for this
                    server
                  example:
                    - GMAIL_ADD_LABEL_TO_EMAIL
                managed_auth_via_composio:
                  type: boolean
                  description: Whether the MCP server is managed by Composio
                  example: true
                auth_config_ids:
                  type: array
                  items:
                    type: string
                  description: List of auth config IDs to use for this MCP server.
                  example:
                    - ac_1a2b3c4d5e6f
                    - ac_7g8h9i0j1k2l
              description: Parameters for updating an existing MCP server configuration
            examples:
              Update Server Name:
                value:
                  name: Updated GitHub Integration Server
              Update Single Auth Config:
                value:
                  auth_config_ids:
                    - ac_1a2b3c4d5e6f
                  toolkits:
                    - gmail
                  allowed_tools:
                    - GMAIL_ADD_LABEL_TO_EMAIL
              Update Multiple Auth Configs:
                value:
                  auth_config_ids:
                    - ac_1a2b3c4d5e6f
                    - ac_7g8h9i0j1k2l
                  toolkits:
                    - gmail
                    - notion
                  allowed_tools:
                    - GMAIL_ADD_LABEL_TO_EMAIL
                    - NOTION_CREATE_NOTION_PAGE
              Update Toolkits Only:
                value:
                  toolkits:
                    - gmail
                    - notion
              Full Update:
                value:
                  name: Production Multi-App MCP Server
                  auth_config_ids:
                    - ac_1a2b3c4d5e6f
                    - ac_7g8h9i0j1k2l
                  toolkits:
                    - gmail
                    - notion
                  allowed_tools:
                    - GMAIL_ADD_LABEL_TO_EMAIL
                    - NOTION_CREATE_NOTION_PAGE
      responses:
        '200':
          description: >-
            Successfully updated MCP server. Returns the complete updated server
            configuration including connection details, authentication settings,
            and available tools.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: UUID of the MCP server instance
                    example: 550e8400-e29b-41d4-a716-446655440000
                  name:
                    type: string
                    description: User-defined descriptive name for this MCP server
                    example: GitHub Integration Server
                  auth_config_ids:
                    type: array
                    items:
                      type: string
                    description: >-
                      ID references to the auth configurations used by this
                      server
                    example:
                      - ac_1a2b3c4d5e6f
                      - ac_7g8h9i0j1k2l
                  allowed_tools:
                    type: array
                    items:
                      type: string
                    description: Array of tool slugs that this MCP server is allowed to use
                    example:
                      - GITHUB_CREATE_AN_ISSUE
                      - GITHUB_GET_A_REPOSITORY
                      - GITHUB_LIST_PULL_REQUESTS
                  mcp_url:
                    type: string
                    description: >-
                      [DEPRECATED] Please use the URL with user_id or
                      connected_account_id query param
                    deprecated: true
                    example: >-
                      https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john
                  toolkits:
                    type: array
                    items:
                      type: string
                    description: >-
                      Array of toolkit slugs that this MCP server is allowed to
                      use
                    example:
                      - github
                      - jira
                      - slack
                  toolkit_icons:
                    type: object
                    additionalProperties:
                      type: string
                    description: >-
                      Object mapping each toolkit slug to its icon/logo URL for
                      display purposes
                    example:
                      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:
                    type: object
                    properties:
                      cursor:
                        type: string
                        description: Command line instruction for Cursor client setup
                        deprecated: true
                        example: >-
                          npx @composio/mcp@latest setup
                          "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"
                          --client cursor
                      claude:
                        type: string
                        description: Command line instruction for Claude client setup
                        deprecated: true
                        example: >-
                          npx @composio/mcp@latest setup
                          "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"
                          --client claude
                      windsurf:
                        type: string
                        description: Command line instruction for Windsurf client setup
                        deprecated: true
                        example: >-
                          npx @composio/mcp@latest setup
                          "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john"
                          --client windsurf
                    required:
                      - cursor
                      - claude
                      - windsurf
                    description: >-
                      Set of command line instructions for connecting various
                      clients to this MCP server
                    deprecated: true
                  updated_at:
                    type: string
                    description: >-
                      Date and time when this server configuration was last
                      modified
                    example: '2023-06-15T14:30:00.000Z'
                  created_at:
                    type: string
                    description: Date and time when this server was initially created
                    example: '2023-06-10T09:15:00.000Z'
                  server_instance_count:
                    type: number
                    description: >-
                      Total count of active user instances connected to this
                      server
                    example: 5
                  managed_auth_via_composio:
                    type: boolean
                    description: Whether the MCP server is managed by Composio
                    example: true
                  deleted:
                    type: boolean
                    description: Whether the MCP server is deleted
                required:
                  - id
                  - name
                  - auth_config_ids
                  - allowed_tools
                  - mcp_url
                  - toolkits
                  - toolkit_icons
                  - commands
                  - updated_at
                  - created_at
                  - server_instance_count
                  - managed_auth_via_composio
                  - deleted
                description: MCP server configuration and connection details
        '400':
          description: >-
            Bad request. The request parameters may be invalid or in an
            incorrect format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication is required or the provided credentials
            are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Forbidden. The authenticated user does not have permission to update
            this MCP server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            MCP server not found. No server with the specified ID exists or it
            has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error. An unexpected error occurred while processing
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      deprecated: true
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key

````