View a markdown version of this page

ProtocolConfiguration - Amazon Bedrock AgentCore Control Plane

ProtocolConfiguration

The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients.

Contents

serverProtocol

The server protocol for the agent runtime. This field specifies which protocol the agent runtime uses to communicate with clients.

Type: String

Valid Values: MCP | HTTP | A2A | AGUI

Required: Yes

path

The path on which the agent server accepts requests. The path must begin with /. When this field is omitted, the default is /invocations for HTTP and AGUI, /mcp for MCP, and / for A2A.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Pattern: /[A-Za-z0-9\-._~/%]*

Required: No

port

The port on which the agent server listens. The port must be between 8000 and 12000, excluding the reserved port 8443. When this field is omitted, the default is 8080 for HTTP and AGUI, 8000 for MCP, and 9000 for A2A.

Type: Integer

Valid Range: Minimum value of 8000. Maximum value of 12000.

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: