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

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"

api/datadogV1/model_synthetics_api_test_step_subtype.go

@@ -23,6 +23,7 @@ const (
 	SYNTHETICSAPITESTSTEPSUBTYPE_UDP       SyntheticsAPITestStepSubtype = "udp"
 	SYNTHETICSAPITESTSTEPSUBTYPE_ICMP      SyntheticsAPITestStepSubtype = "icmp"
 	SYNTHETICSAPITESTSTEPSUBTYPE_WEBSOCKET SyntheticsAPITestStepSubtype = "websocket"
+	SYNTHETICSAPITESTSTEPSUBTYPE_MCP       SyntheticsAPITestStepSubtype = "mcp"
 )
 
 var allowedSyntheticsAPITestStepSubtypeEnumValues = []SyntheticsAPITestStepSubtype{
@@ -34,6 +35,7 @@ var allowedSyntheticsAPITestStepSubtypeEnumValues = []SyntheticsAPITestStepSubty
 	SYNTHETICSAPITESTSTEPSUBTYPE_UDP,
 	SYNTHETICSAPITESTSTEPSUBTYPE_ICMP,
 	SYNTHETICSAPITESTSTEPSUBTYPE_WEBSOCKET,
+	SYNTHETICSAPITESTSTEPSUBTYPE_MCP,
 }
 
 // GetAllowedValues reeturns the list of possible values.

api/datadogV1/model_synthetics_assertion.go

@@ -11,12 +11,14 @@ import (
 // SyntheticsAssertion - Object describing the assertions type, their associated operator,
 // which property they apply, and upon which target.
 type SyntheticsAssertion struct {
-	SyntheticsAssertionTarget           *SyntheticsAssertionTarget
-	SyntheticsAssertionBodyHashTarget   *SyntheticsAssertionBodyHashTarget
-	SyntheticsAssertionJSONPathTarget   *SyntheticsAssertionJSONPathTarget
-	SyntheticsAssertionJSONSchemaTarget *SyntheticsAssertionJSONSchemaTarget
-	SyntheticsAssertionXPathTarget      *SyntheticsAssertionXPathTarget
-	SyntheticsAssertionJavascript       *SyntheticsAssertionJavascript
+	SyntheticsAssertionTarget                      *SyntheticsAssertionTarget
+	SyntheticsAssertionBodyHashTarget              *SyntheticsAssertionBodyHashTarget
+	SyntheticsAssertionJSONPathTarget              *SyntheticsAssertionJSONPathTarget
+	SyntheticsAssertionJSONSchemaTarget            *SyntheticsAssertionJSONSchemaTarget
+	SyntheticsAssertionXPathTarget                 *SyntheticsAssertionXPathTarget
+	SyntheticsAssertionJavascript                  *SyntheticsAssertionJavascript
+	SyntheticsAssertionMCPServerCapabilitiesTarget *SyntheticsAssertionMCPServerCapabilitiesTarget
+	SyntheticsAssertionMCPRespectsSpecification    *SyntheticsAssertionMCPRespectsSpecification
 
 	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
 	UnparsedObject interface{}
@@ -52,6 +54,16 @@ func SyntheticsAssertionJavascriptAsSyntheticsAssertion(v *SyntheticsAssertionJa
 	return SyntheticsAssertion{SyntheticsAssertionJavascript: v}
 }
 
+// SyntheticsAssertionMCPServerCapabilitiesTargetAsSyntheticsAssertion is a convenience function that returns SyntheticsAssertionMCPServerCapabilitiesTarget wrapped in SyntheticsAssertion.
+func SyntheticsAssertionMCPServerCapabilitiesTargetAsSyntheticsAssertion(v *SyntheticsAssertionMCPServerCapabilitiesTarget) SyntheticsAssertion {
+	return SyntheticsAssertion{SyntheticsAssertionMCPServerCapabilitiesTarget: v}
+}
+
+// SyntheticsAssertionMCPRespectsSpecificationAsSyntheticsAssertion is a convenience function that returns SyntheticsAssertionMCPRespectsSpecification wrapped in SyntheticsAssertion.
+func SyntheticsAssertionMCPRespectsSpecificationAsSyntheticsAssertion(v *SyntheticsAssertionMCPRespectsSpecification) SyntheticsAssertion {
+	return SyntheticsAssertion{SyntheticsAssertionMCPRespectsSpecification: v}
+}
+
 // UnmarshalJSON turns data into one of the pointers in the struct.
 func (obj *SyntheticsAssertion) UnmarshalJSON(data []byte) error {
 	var err error
@@ -158,6 +170,40 @@ func (obj *SyntheticsAssertion) UnmarshalJSON(data []byte) error {
 		obj.SyntheticsAssertionJavascript = nil
 	}
 
+	// try to unmarshal data into SyntheticsAssertionMCPServerCapabilitiesTarget
+	err = datadog.Unmarshal(data, &obj.SyntheticsAssertionMCPServerCapabilitiesTarget)
+	if err == nil {
+		if obj.SyntheticsAssertionMCPServerCapabilitiesTarget != nil && obj.SyntheticsAssertionMCPServerCapabilitiesTarget.UnparsedObject == nil {
+			jsonSyntheticsAssertionMCPServerCapabilitiesTarget, _ := datadog.Marshal(obj.SyntheticsAssertionMCPServerCapabilitiesTarget)
+			if string(jsonSyntheticsAssertionMCPServerCapabilitiesTarget) == "{}" { // empty struct
+				obj.SyntheticsAssertionMCPServerCapabilitiesTarget = nil
+			} else {
+				match++
+			}
+		} else {
+			obj.SyntheticsAssertionMCPServerCapabilitiesTarget = nil
+		}
+	} else {
+		obj.SyntheticsAssertionMCPServerCapabilitiesTarget = nil
+	}
+
+	// try to unmarshal data into SyntheticsAssertionMCPRespectsSpecification
+	err = datadog.Unmarshal(data, &obj.SyntheticsAssertionMCPRespectsSpecification)
+	if err == nil {
+		if obj.SyntheticsAssertionMCPRespectsSpecification != nil && obj.SyntheticsAssertionMCPRespectsSpecification.UnparsedObject == nil {
+			jsonSyntheticsAssertionMCPRespectsSpecification, _ := datadog.Marshal(obj.SyntheticsAssertionMCPRespectsSpecification)
+			if string(jsonSyntheticsAssertionMCPRespectsSpecification) == "{}" { // empty struct
+				obj.SyntheticsAssertionMCPRespectsSpecification = nil
+			} else {
+				match++
+			}
+		} else {
+			obj.SyntheticsAssertionMCPRespectsSpecification = nil
+		}
+	} else {
+		obj.SyntheticsAssertionMCPRespectsSpecification = nil
+	}
+
 	if match != 1 { // more than 1 match
 		// reset to nil
 		obj.SyntheticsAssertionTarget = nil
@@ -166,6 +212,8 @@ func (obj *SyntheticsAssertion) UnmarshalJSON(data []byte) error {
 		obj.SyntheticsAssertionJSONSchemaTarget = nil
 		obj.SyntheticsAssertionXPathTarget = nil
 		obj.SyntheticsAssertionJavascript = nil
+		obj.SyntheticsAssertionMCPServerCapabilitiesTarget = nil
+		obj.SyntheticsAssertionMCPRespectsSpecification = nil
 		return datadog.Unmarshal(data, &obj.UnparsedObject)
 	}
 	return nil // exactly one match
@@ -197,6 +245,14 @@ func (obj SyntheticsAssertion) MarshalJSON() ([]byte, error) {
 		return datadog.Marshal(&obj.SyntheticsAssertionJavascript)
 	}
 
+	if obj.SyntheticsAssertionMCPServerCapabilitiesTarget != nil {
+		return datadog.Marshal(&obj.SyntheticsAssertionMCPServerCapabilitiesTarget)
+	}
+
+	if obj.SyntheticsAssertionMCPRespectsSpecification != nil {
+		return datadog.Marshal(&obj.SyntheticsAssertionMCPRespectsSpecification)
+	}
+
 	if obj.UnparsedObject != nil {
 		return datadog.Marshal(obj.UnparsedObject)
 	}
@@ -229,6 +285,14 @@ func (obj *SyntheticsAssertion) GetActualInstance() interface{} {
 		return obj.SyntheticsAssertionJavascript
 	}
 
+	if obj.SyntheticsAssertionMCPServerCapabilitiesTarget != nil {
+		return obj.SyntheticsAssertionMCPServerCapabilitiesTarget
+	}
+
+	if obj.SyntheticsAssertionMCPRespectsSpecification != nil {
+		return obj.SyntheticsAssertionMCPRespectsSpecification
+	}
+
 	// all schemas are nil
 	return nil
 }