interface McpConfiguration 🔹

Language	Type name
.NET	`Amazon.CDK.AWS.Bedrock.Agentcore.Alpha.McpConfiguration`
Go	`github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2#McpConfiguration`
Java	`software.amazon.awscdk.services.bedrock.agentcore.alpha.McpConfiguration`
Python	`aws_cdk.aws_bedrock_agentcore_alpha.McpConfiguration`
TypeScript (source)	`@aws-cdk/aws-bedrock-agentcore-alpha` » `McpConfiguration`

MCP protocol configuration The configuration for the Model Context Protocol (MCP).

This protocol enables communication between Amazon Bedrock Agent and external tools.

Example

// Create a KMS key for encryption
const encryptionKey = new kms.Key(this, "GatewayEncryptionKey", {
  enableKeyRotation: true,
  description: "KMS key for gateway encryption",
});

// Create gateway with KMS encryption
const gateway = new agentcore.Gateway(this, "MyGateway", {
  gatewayName: "my-encrypted-gateway",
  description: "Gateway with KMS encryption",
  protocolConfiguration: new agentcore.McpProtocolConfiguration({
    instructions: "Use this gateway to connect to external MCP tools",
    searchType: agentcore.McpGatewaySearchType.SEMANTIC,
    supportedVersions: [agentcore.MCPProtocolVersion.MCP_2025_03_26],
  }),
  authorizerConfiguration: agentcore.GatewayAuthorizer.usingCustomJwt({
    discoveryUrl: "https://auth.example.com/.well-known/openid-configuration",
    allowedAudience: ["my-app"],
    allowedClients: ["my-client-id"],
  }),
  kmsKey: encryptionKey,
  exceptionLevel: agentcore.GatewayExceptionLevel.DEBUG,
});

Properties

Name	Type	Description
instructions?🔹	`string`	The instructions for using the Model Context Protocol gateway.
searchType?🔹	`McpGatewaySearchType`	The search type for the Model Context Protocol gateway.
supportedVersions?🔹	`MCPProtocolVersion[]`	The supported versions of the Model Context Protocol.

instructions?🔹

Type: string (optional, default: No instructions provided)

The instructions for using the Model Context Protocol gateway.

These instructions provide guidance on how to interact with the gateway.

searchType?🔹

Type: McpGatewaySearchType (optional, default: No search type specified)

The search type for the Model Context Protocol gateway.

This field specifies how the gateway handles search operations.

supportedVersions?🔹

Type: MCPProtocolVersion[] (optional, default: No specific versions specified)

The supported versions of the Model Context Protocol.

This field specifies which versions of the protocol the gateway can use.

AWS CDK