McpExternalOperation

A tool that calls an MCP connector.

Kind: an object, used in responses.

Fields

Every field is present in a response; empty ones are null.

Field	Type	Description
versions	McpExternalOperationVersion[]	Every version of the tool, oldest first.
name	string	The tool’s name, unique within its namespace. The model calls the tool by this name unless a binding renames it.
namespaceId	uuid	The id of the namespace it belongs to.
tenantId	uuid	The id of the tenant it belongs to.
id	uuid	The unique id. Use it in by-id routes and wherever another object refers to this one.
dateCreated	datetime	When it was created, in UTC.
dateUpdated	datetime	When it was last changed, in UTC.

Example

{
  "versions": [
    {
      "connectorId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
      "connectorVersion": 0,
      "requestBindings": [],
      "authenticationHeader": {},
      "promptGuidance": "...",
      "requiresApproval": false,
      "version": 0,
      "date": "2026-10-26T12:00:00.0000000Z",
      "isDisabled": false
    }
  ],
  "name": "...",
  "namespaceId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "tenantId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "id": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "dateCreated": "2026-10-26T12:00:00.0000000Z",
  "dateUpdated": "2026-10-26T12:00:00.0000000Z"
}

Where it’s used

• tools.createMcp (POST /namespaces/{namespaceName}/external-operations/mcp)
• Inside BuildEntityOfMcpExternalOperation
• Inside ExternalOperation