McpProtocolConfiguration

class aws_cdk.aws_bedrock_agentcore_alpha.McpProtocolConfiguration(*, instructions=None, search_type=None, supported_versions=None)

Bases: object

(experimental) MCP (Model Context Protocol) configuration implementation.

Stability:: experimental
ExampleMetadata:: fixture=default infused

Example:

# Create a KMS key for encryption
encryption_key = kms.Key(self, "GatewayEncryptionKey",
    enable_key_rotation=True,
    description="KMS key for gateway encryption"
)

# Create gateway with KMS encryption
gateway = agentcore.Gateway(self, "MyGateway",
    gateway_name="my-encrypted-gateway",
    description="Gateway with KMS encryption",
    protocol_configuration=agentcore.McpProtocolConfiguration(
        instructions="Use this gateway to connect to external MCP tools",
        search_type=agentcore.McpGatewaySearchType.SEMANTIC,
        supported_versions=[agentcore.MCPProtocolVersion.MCP_2025_03_26]
    ),
    authorizer_configuration=agentcore.GatewayAuthorizer.using_custom_jwt(
        discovery_url="https://auth.example.com/.well-known/openid-configuration",
        allowed_audience=["my-app"],
        allowed_clients=["my-client-id"]
    ),
    kms_key=encryption_key,
    exception_level=agentcore.GatewayExceptionLevel.DEBUG
)

Parameters:

instructions (Optional[str]) – (experimental) The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. Default: - No instructions provided
search_type (Optional[McpGatewaySearchType]) – (experimental) The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. Default: - No search type specified
supported_versions (Optional[Sequence[MCPProtocolVersion]]) – (experimental) The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. Default: - No specific versions specified

Stability:

experimental

Attributes

instructions

(experimental) Instructions for using the MCP gateway.

Stability:: experimental

protocol_type

(experimental) The protocol type.

Stability:: experimental

search_type

(experimental) The search type for the MCP gateway.

Stability:: experimental

supported_versions

(experimental) The supported MCP protocol versions.

Stability:: experimental