ORorq-ai
MCP Gateway

Update an MCP server

Changed on

Updates mutable fields of an existing MCP server. Omitted optional fields keep their current values.

patch/v2/mcp-servers/{id}

Request

  • Base URL
    https://my.orq.ai
  • URL
    https://my.orq.ai/v2/mcp-servers/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Unique identifier of the MCP server.

Request body

keystring

Rejected with INVALID_ARGUMENT: the key prefixes this server's tools in every gateway that exposes it, so it is immutable after creation. Retained so callers get an error rather than a silently ignored field.

display_namestring

Human readable name shown in the workspace.

descriptionstring

Free-form note about what this server is for.

Example request

{
  "connection": {
    "url": "https://api.githubcopilot.com/mcp/"
  },
  "auth": {
    "static_headers": [
      {
        "key": "Authorization",
        "value": "ghp_xxxxxxxxxxxx"
      }
    ]
  },
  "default_tool_exposure": {
    "mode": "MCP_TOOL_EXPOSURE_MODE_ALL"
  }
}

Response

OK

Example response

{
  "mcp_server": {
    "connection": {
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "auth": {
      "static_headers": [
        {
          "key": "Authorization",
          "value": "ghp_xxxxxxxxxxxx"
        }
      ]
    },
    "default_tool_exposure": {
      "mode": "MCP_TOOL_EXPOSURE_MODE_ALL"
    }
  }
}

Changes

  • 928a71e92252Revision changes
    • warning

      added the new MCP_CONNECTION_TYPE_OPENAPI enum value to the ////// response property for the response status

    • info

      added the new optional request property //////////

    • info

      added the new optional request property //////////

    • info

      added the new optional request property

    • info

      request property ///// deprecated

    • info

      request property ///////// deprecated

    • info

      added the new MCP_CONNECTION_TYPE_OPENAPI enum value to the request property /////

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      response property mcp_server/auth/allOf[McpAuthConfig]/enterprise deprecated

    • info

      response property mcp_server/auth/allOf[McpAuthConfig]/enterprise/allOf[McpEnterpriseAuthConfig]/ deprecated

  • 33d63277cd4eRevision changes
    • breaking

      removed the enum value MCP_CONNECTION_TYPE_OPENAPI of the request property /////

    • warning

      removed the request property //////////

    • warning

      removed the request property //////////

    • warning

      removed the request property

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      request property ///// reactivated

    • info

      request property ///////// reactivated

    • info

      removed the MCP_CONNECTION_TYPE_OPENAPI enum value from the ////// response property for the response status

    • info

      response property mcp_server/auth/allOf[McpAuthConfig]/enterprise reactivated

    • info

      response property mcp_server/auth/allOf[McpAuthConfig]/enterprise/allOf[McpEnterpriseAuthConfig]/ reactivated