Add mcp step subtype to synthetics multi-step api tests (DataDog#3356)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -16342,6 +16342,7 @@ components:
         - udp
         - icmp
         - websocket
+        - mcp
       example: http
       type: string
       x-enum-varnames:
@@ -16353,6 +16354,7 @@ components:
         - UDP
         - ICMP
         - WEBSOCKET
+        - MCP
     SyntheticsAPITestType:
       default: "api"
       description: Type of the Synthetic test, `api`.
@@ -16475,6 +16477,8 @@ components:
         - $ref: "#/components/schemas/SyntheticsAssertionJSONSchemaTarget"
         - $ref: "#/components/schemas/SyntheticsAssertionXPathTarget"
         - $ref: "#/components/schemas/SyntheticsAssertionJavascript"
+        - $ref: "#/components/schemas/SyntheticsAssertionMCPServerCapabilitiesTarget"
+        - $ref: "#/components/schemas/SyntheticsAssertionMCPRespectsSpecification"
     SyntheticsAssertionBodyHashOperator:
       description: Assertion operator to apply.
       enum:
@@ -16610,6 +16614,49 @@ components:
       type: string
       x-enum-varnames:
         - JAVASCRIPT
+    SyntheticsAssertionMCPRespectsSpecification:
+      description: An assertion that verifies the MCP server response respects the MCP specification.
+      properties:
+        type:
+          $ref: "#/components/schemas/SyntheticsAssertionMCPRespectsSpecificationType"
+      required:
+        - type
+      type: object
+    SyntheticsAssertionMCPRespectsSpecificationType:
+      description: Type of the assertion.
+      enum:
+        - mcpRespectsSpecification
+      example: mcpRespectsSpecification
+      type: string
+      x-enum-varnames:
+        - MCP_RESPECTS_SPECIFICATION
+    SyntheticsAssertionMCPServerCapabilitiesTarget:
+      description: An assertion that checks that an MCP server advertises the expected capabilities.
+      properties:
+        operator:
+          $ref: "#/components/schemas/SyntheticsAssertionOperator"
+        target:
+          description: List of MCP server capabilities to assert against.
+          example:
+            - completions
+          items:
+            $ref: "#/components/schemas/SyntheticsMCPServerCapability"
+          type: array
+        type:
+          $ref: "#/components/schemas/SyntheticsAssertionMCPServerCapabilitiesType"
+      required:
+        - type
+        - operator
+        - target
+      type: object
+    SyntheticsAssertionMCPServerCapabilitiesType:
+      description: Type of the assertion.
+      enum:
+        - mcpServerCapabilities
+      example: mcpServerCapabilities
+      type: string
+      x-enum-varnames:
+        - MCP_SERVER_CAPABILITIES
     SyntheticsAssertionOperator:
       description: Assertion operator to apply.
       enum:
@@ -16712,6 +16759,8 @@ components:
         - connection
         - multiNetworkHop
         - jitter
+        - mcpToolNameLength
+        - mcpToolCount
       example: statusCode
       type: string
       x-enum-varnames:
@@ -16736,6 +16785,8 @@ components:
         - CONNECTION
         - MULTI_NETWORK_HOP
         - JITTER
+        - MCP_TOOL_NAME_LENGTH
+        - MCP_TOOL_COUNT
     SyntheticsAssertionXPathOperator:
       description: Assertion operator to apply.
       enum:
@@ -18044,6 +18095,31 @@ components:
             $ref: "#/components/schemas/SyntheticsLocation"
           type: array
       type: object
+    SyntheticsMCPProtocolVersion:
+      description: The MCP protocol version used by the step. See https://modelcontextprotocol.io/specification.
+      enum:
+        - "2025-06-18"
+      example: "2025-06-18"
+      type: string
+      x-enum-varnames:
+        - VERSION_2025_06_18
+    SyntheticsMCPServerCapability:
+      description: A capability advertised by an MCP server.
+      enum:
+        - completions
+        - experimental
+        - logging
+        - prompts
+        - resources
+        - tools
+      type: string
+      x-enum-varnames:
+        - COMPLETIONS
+        - EXPERIMENTAL
+        - LOGGING
+        - PROMPTS
+        - RESOURCES
+        - TOOLS
     SyntheticsMobileStep:
       description: The steps used in a Synthetic mobile test.
       properties:
@@ -18933,15 +19009,24 @@ components:
         - UPLOAD_FILES
         - WAIT
     SyntheticsTestCallType:
-      description: The type of gRPC call to perform.
+      description: |-
+        The type of call to perform. Used by gRPC steps (`healthcheck`, `unary`)
+        and MCP steps (`init`, `tool_list`, `tool_call`). Valid values depend on
+        the parent step's `subtype`.
       enum:
         - healthcheck
         - unary
+        - init
+        - tool_list
+        - tool_call
       example: unary
       type: string
       x-enum-varnames:
         - HEALTHCHECK
         - UNARY
+        - INIT
+        - TOOL_LIST
+        - TOOL_CALL
     SyntheticsTestCiOptions:
       description: CI/CD options for a Synthetic test.
       properties:
@@ -19442,6 +19527,8 @@ components:
         isMessageBase64Encoded:
           description: Whether the message is base64 encoded.
           type: boolean
+        mcpProtocolVersion:
+          $ref: "#/components/schemas/SyntheticsMCPProtocolVersion"
         message:
           description: Message to send for UDP or WebSocket tests.
           type: string
@@ -19486,6 +19573,14 @@ components:
           description: Timeout in seconds for the test.
           format: double
           type: number
+        toolArgs:
+          additionalProperties: {}
+          description: Arguments to pass to the MCP tool. Free-form object whose shape depends on the tool. Used when `callType` is `tool_call`.
+          type: object
+        toolName:
+          description: The name of the MCP tool to call. Required when `callType` is `tool_call`.
+          example: search
+          type: string
         url:
           description: URL to perform the test with.
           example: "https://example.com"

cassettes/features/v1/synthetics/Create-an-API-test-with-MCP-steps-returns-OK-Returns-the-created-test-details-response.frozen

@@ -0,0 +1 @@
+2026-05-19T16:45:21.251Z

cassettes/features/v1/synthetics/Create-an-API-test-with-MCP-steps-returns-OK-Returns-the-created-test-details-response.yml

@@ -0,0 +1,143 @@
+# Create an API test with MCP steps returns "OK - Returns the created test details." response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V1::SyntheticsAPI.new
+
+body = DatadogAPIClient::V1::SyntheticsAPITest.new({
+  config: DatadogAPIClient::V1::SyntheticsAPITestConfig.new({
+    steps: [
+      DatadogAPIClient::V1::SyntheticsAPITestStep.new({
+        name: "Initialize MCP session",
+        subtype: DatadogAPIClient::V1::SyntheticsAPITestStepSubtype::MCP,
+        allow_failure: false,
+        is_critical: true,
+        _retry: DatadogAPIClient::V1::SyntheticsTestOptionsRetry.new({
+          count: 0,
+          interval: 300,
+        }),
+        assertions: [
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::IS,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::STATUS_CODE,
+            target: 200,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecification.new({
+            type: DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecificationType::MCP_RESPECTS_SPECIFICATION,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionMCPServerCapabilitiesTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::CONTAINS,
+            type: DatadogAPIClient::V1::SyntheticsAssertionMCPServerCapabilitiesType::MCP_SERVER_CAPABILITIES,
+            target: [
+              DatadogAPIClient::V1::SyntheticsMCPServerCapability::TOOLS,
+            ],
+          }),
+        ],
+        request: DatadogAPIClient::V1::SyntheticsTestRequest.new({
+          url: "https://example.org/mcp",
+          call_type: DatadogAPIClient::V1::SyntheticsTestCallType::INIT,
+          mcp_protocol_version: DatadogAPIClient::V1::SyntheticsMCPProtocolVersion::VERSION_2025_06_18,
+          headers: {
+            "DD-API-KEY" => "<YOUR-API-KEY>", "DD-APPLICATION-KEY" => "<YOUR-APP-KEY>",
+          },
+        }),
+      }),
+      DatadogAPIClient::V1::SyntheticsAPITestStep.new({
+        name: "List MCP tools",
+        subtype: DatadogAPIClient::V1::SyntheticsAPITestStepSubtype::MCP,
+        allow_failure: false,
+        is_critical: true,
+        _retry: DatadogAPIClient::V1::SyntheticsTestOptionsRetry.new({
+          count: 0,
+          interval: 300,
+        }),
+        assertions: [
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::IS,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::STATUS_CODE,
+            target: 200,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::MORE_THAN,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::MCP_TOOL_COUNT,
+            target: 0,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::LESS_THAN,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::MCP_TOOL_NAME_LENGTH,
+            target: 64,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecification.new({
+            type: DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecificationType::MCP_RESPECTS_SPECIFICATION,
+          }),
+        ],
+        request: DatadogAPIClient::V1::SyntheticsTestRequest.new({
+          url: "https://example.org/mcp",
+          call_type: DatadogAPIClient::V1::SyntheticsTestCallType::TOOL_LIST,
+          mcp_protocol_version: DatadogAPIClient::V1::SyntheticsMCPProtocolVersion::VERSION_2025_06_18,
+          headers: {
+            "DD-API-KEY" => "<YOUR-API-KEY>", "DD-APPLICATION-KEY" => "<YOUR-APP-KEY>",
+          },
+        }),
+      }),
+      DatadogAPIClient::V1::SyntheticsAPITestStep.new({
+        name: "Call MCP search tool",
+        subtype: DatadogAPIClient::V1::SyntheticsAPITestStepSubtype::MCP,
+        allow_failure: false,
+        is_critical: true,
+        _retry: DatadogAPIClient::V1::SyntheticsTestOptionsRetry.new({
+          count: 0,
+          interval: 300,
+        }),
+        assertions: [
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::IS,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::STATUS_CODE,
+            target: 200,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionTarget.new({
+            operator: DatadogAPIClient::V1::SyntheticsAssertionOperator::LESS_THAN,
+            type: DatadogAPIClient::V1::SyntheticsAssertionType::RESPONSE_TIME,
+            target: 5000,
+          }),
+          DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecification.new({
+            type: DatadogAPIClient::V1::SyntheticsAssertionMCPRespectsSpecificationType::MCP_RESPECTS_SPECIFICATION,
+          }),
+        ],
+        request: DatadogAPIClient::V1::SyntheticsTestRequest.new({
+          url: "https://example.org/mcp",
+          call_type: DatadogAPIClient::V1::SyntheticsTestCallType::TOOL_CALL,
+          mcp_protocol_version: DatadogAPIClient::V1::SyntheticsMCPProtocolVersion::VERSION_2025_06_18,
+          tool_name: "search",
+          tool_args: {
+            "limit": "5", "query": "datadog synthetics",
+          },
+          headers: {
+            "DD-API-KEY" => "<YOUR-API-KEY>", "DD-APPLICATION-KEY" => "<YOUR-APP-KEY>",
+          },
+        }),
+      }),
+    ],
+  }),
+  locations: [
+    "aws:us-east-2",
+  ],
+  message: "BDD test payload: synthetics_api_test_mcp_payload.json",
+  name: "Example-Synthetic",
+  options: DatadogAPIClient::V1::SyntheticsTestOptions.new({
+    min_failure_duration: 10,
+    min_location_failed: 1,
+    monitor_name: "Example-Synthetic",
+    monitor_priority: 5,
+    _retry: DatadogAPIClient::V1::SyntheticsTestOptionsRetry.new({
+      count: 3,
+      interval: 1000,
+    }),
+    tick_every: 900,
+  }),
+  subtype: DatadogAPIClient::V1::SyntheticsTestDetailsSubType::MULTI,
+  tags: [
+    "testing:api",
+  ],
+  type: DatadogAPIClient::V1::SyntheticsAPITestType::API,
+})
+p api_instance.create_synthetics_api_test(body)

examples/v1/synthetics/CreateSyntheticsAPITest_2547523542.rb

@@ -30,10 +30,12 @@
         DatadogAPIClient::V1::SyntheticsTestRequestBodyFile.new({}),
       ],
       http_version: DatadogAPIClient::V1::SyntheticsTestOptionsHTTPVersion::HTTP1,
+      mcp_protocol_version: DatadogAPIClient::V1::SyntheticsMCPProtocolVersion::VERSION_2025_06_18,
       proxy: DatadogAPIClient::V1::SyntheticsTestRequestProxy.new({
         url: "https://example.com",
       }),
       service: "Greeter",
+      tool_name: "search",
       url: "https://example.com",
     }),
     variables: [