Skip to content
v2.273.0

McpConfiguration Struct ​

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

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

Example ​

ts
// 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"],
    allowedScopes: ["read", "write"],
  }),
  kmsKey: encryptionKey,
  exceptionLevel: agentcore.GatewayExceptionLevel.DEBUG,
});

Properties ​

instructionsstringinstructionsstrinstructionsStringInstructionsstringInstructions*string= No instructions provided#
The instructions for using the Model Context Protocol gateway.

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

searchTypeMcpGatewaySearchTypesearch_typeMcpGatewaySearchTypesearchTypeMcpGatewaySearchTypeSearchTypeMcpGatewaySearchTypeSearchTypeMcpGatewaySearchType= No search type specified#
The search type for the Model Context Protocol gateway.

This field specifies how the gateway handles search operations.

supportedVersionsMCPProtocolVersion[]supported_versionstyping.List[MCPProtocolVersion]supportedVersionsList<MCPProtocolVersion>SupportedVersionsMCPProtocolVersion[]SupportedVersions*[]MCPProtocolVersion= No specific versions specified#
The supported versions of the Model Context Protocol.

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

Used as props by ​