MCPs

Download AsyncAPI spec

Events emitted when tools are executed against the Model Context Protocol (MCP) Server in a Qlik Cloud tenant.

  • com.qlik.ai.mcp.tool.executed is published when an individual tool is executed, and includes the tool name, the client ID of the OAuth application that requested the execution, the execution latency in milliseconds, and any error message if the execution failed.
  • com.qlik.ai.mcp.tool.calls.aggregated is published when a set of tool calls are made, and summarizes a batch of tool calls with the count of calls, the total execution latency across all calls, and references to the individual tool execution events for traceability.

Use these events to analyze tool usage patterns, detect performance trends, and monitor tool performance.

Availability

These events are currently available for consumption via Audits (Events) only.

Tool calls aggregated

Published when aggregated tool call metrics are generated after a configured threshold (default 5 tool calls) or timeout. Includes the count of tool calls, total execution latency across all calls in milliseconds, and event IDs of the individual tool execution events. Use this to analyze tool usage patterns and detect performance trends.

Payload

object
  • idstring
    Required

    Identifies the event.

    minLength = 1

  • timestring

    Timestamp of when the occurrence happened. Must adhere to RFC 3339.

    minLength = 1, format = "date-time"

  • sourcestring
    Required

    Identifies the context in which an event happened.

    minLength = 1, format = "uri-reference", default = "com.qlik/mcp"

  • specversionstring
    Required

    The version of the CloudEvents specification which the event uses.

    Can be one of: "1.0"

    minLength = 1, default = "1.0"

  • datacontenttypestring

    Content type of the data value. Must adhere to RFC 2046 format.

    minLength = 1, default = "application/json"

  • useridstring
    Required

    The unique identifier for the user related to the event.

    format = "uuid"

  • tenantidstring
    Required

    The unique identifier for the tenant related to the event.

    format = "uuid"

  • dataobject

    The aggregated metrics for a batch of tool calls, including the count of tools executed, cumulative latency across all calls, and references to individual tool execution events for traceability.

    Show data properties
    • eventIdsarray of strings
      Required

      The list of CloudEvent IDs from individual tool execution events that were aggregated. Provides traceability to the original toolExecuted events for detailed analysis.

    • toolCountinteger
      Required

      The number of tool calls aggregated in this event.

    • totalLatencyMsinteger
      Required

      The total execution latency across all aggregated tool calls, in milliseconds.
  • typestring
    Required

    The event type identifier, following CloudEvents specification.

    default = "com.qlik.ai.mcp.tool.calls.aggregated"

com.qlik.ai.mcp.tool.calls.aggregated

Example payload of the "Tool calls aggregated" event

{
  "id": "id123",
  "time": "2018-10-30T07:06:22Z",
  "source": "com.qlik/mcp",
  "specversion": "1.0",
  "datacontenttype": "application/json",
  "userid": "ad378d54-3e97-47c0-bc57-cd84dbb93fa2",
  "tenantid": "103359ca-3579-4125-a0dc-d19531b53186",
  "data": {
    "eventIds": [
      "01JKQZ6X8YABCDEF1234567890",
      "01JKQZ6X8YABCDEF1234567891",
      "01JKQZ6X8YABCDEF1234567892",
      "01JKQZ6X8YABCDEF1234567893",
      "01JKQZ6X8YABCDEF1234567894"
    ],
    "toolCount": 5,
    "totalLatencyMs": 1245
  },
  "type": "com.qlik.ai.mcp.tool.calls.aggregated"
}

Tool executed

Published when a tool is executed in MCP. Includes the tool name, client ID, execution latency in milliseconds, and any error message if execution failed. Use this to monitor tool performance and correlate tool calls.

Payload

object
  • idstring
    Required

    Identifies the event.

    minLength = 1

  • timestring

    Timestamp of when the occurrence happened. Must adhere to RFC 3339.

    minLength = 1, format = "date-time"

  • sourcestring
    Required

    Identifies the context in which an event happened.

    minLength = 1, format = "uri-reference", default = "com.qlik/mcp"

  • specversionstring
    Required

    The version of the CloudEvents specification which the event uses.

    Can be one of: "1.0"

    minLength = 1, default = "1.0"

  • datacontenttypestring

    Content type of the data value. Must adhere to RFC 2046 format.

    minLength = 1, default = "application/json"

  • useridstring
    Required

    The unique identifier for the user related to the event.

    format = "uuid"

  • tenantidstring
    Required

    The unique identifier for the tenant related to the event.

    format = "uuid"

  • dataobject

    The tool execution details, including the tool name, execution time in milliseconds, and any error encountered during execution.

    Show data properties
    • namestring
      Required

      The name of the tool that was executed.

    • errorstring

      Error message if the tool execution failed.

    • latencyinteger
      Required

      The time it took to execute the tool, in milliseconds.
  • typestring
    Required

    The event type identifier, following CloudEvents specification.

    default = "com.qlik.ai.mcp.tool.executed"

  • clientidstring

    The client ID of the OAuth application that requested the tool execution.

com.qlik.ai.mcp.tool.executed

Example payload of the "Tool executed" event

{
  "id": "id123",
  "time": "2018-10-30T07:06:22Z",
  "source": "com.qlik/mcp",
  "specversion": "1.0",
  "datacontenttype": "application/json",
  "userid": "ad378d54-3e97-47c0-bc57-cd84dbb93fa2",
  "tenantid": "103359ca-3579-4125-a0dc-d19531b53186",
  "data": {
    "name": "search_datasets",
    "latency": 123
  },
  "type": "com.qlik.ai.mcp.tool.executed",
  "clientid": "client_12345"
}