Skip to content

protocol-binding

Generated reference page for spec/v1/schemas/resources/protocol-binding.json.

Metadata

  • Type: JSON Schema
  • Source: spec/v1/schemas/resources/protocol-binding.json
  • Raw: View Raw

Summary

Source

json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-service.spec/v1/schemas/resources/protocol-binding.json",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "bindingId",
    "orgId",
    "targetType",
    "targetId",
    "protocol",
    "protocolVersion",
    "endpoint",
    "transports",
    "enabled",
    "createdAt",
    "updatedAt"
  ],
  "properties": {
    "bindingId": {
      "$ref": "../common/identity.json#/$defs/protocolBindingId"
    },
    "orgId": {
      "$ref": "../common/identity.json#/$defs/orgId"
    },
    "targetType": {
      "$ref": "../common/enums.json#/$defs/bindingTargetType"
    },
    "targetId": {
      "$ref": "../common/identity.json#/$defs/opaqueId"
    },
    "protocol": {
      "$ref": "../common/enums.json#/$defs/protocolName"
    },
    "protocolVersion": {
      "type": "string",
      "minLength": 1
    },
    "endpoint": {
      "type": "string",
      "format": "uri-reference"
    },
    "transports": {
      "type": "array",
      "items": {
        "$ref": "../common/protocol-profile.json#/$defs/ProtocolTransport"
      }
    },
    "security": {
      "type": "array",
      "items": {
        "$ref": "../common/protocol-profile.json#/$defs/ProtocolSecurityRequirement"
      }
    },
    "regions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "audiences": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "enabled": {
      "type": "boolean"
    },
    "extensions": {
      "type": "array",
      "items": {
        "$ref": "../common/protocol-profile.json#/$defs/ProtocolExtension"
      }
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    },
    "createdAt": {
      "$ref": "../common/identity.json#/$defs/timestamp"
    },
    "updatedAt": {
      "$ref": "../common/identity.json#/$defs/timestamp"
    },
    "version": {
      "$ref": "../common/identity.json#/$defs/version"
    }
  },
  "allOf": [
    {
      "if": {
        "properties": {
          "protocol": {
            "const": "mcp"
          }
        },
        "required": ["protocol"]
      },
      "then": {
        "properties": {
          "targetType": {
            "const": "mcp_server_revision"
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "targetType": {
            "const": "mcp_server_revision"
          }
        },
        "required": ["targetType"]
      },
      "then": {
        "properties": {
          "protocol": {
            "const": "mcp"
          }
        }
      }
    }
  ]
}

白皮书与规范内容以仓库真源为准。