View a markdown version of this page

AWS::AgentRegistry::Registry - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::AgentRegistry::Registry

The AWS::AgentRegistry::Registry resource specifies a registry. A registry is a managed catalog for publishing and discovering resources such as Model Context Protocol (MCP) servers, agents, and agent skills. It organizes registry records and defines how consumers discover them, how they are authorized, and how submitted records are approved.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::AgentRegistry::Registry",
  "Properties" : {
      "ApprovalConfiguration" : ApprovalConfiguration,
      "AuthorizerType" : String,
      "Description" : String,
      "DiscoveryConfiguration" : DiscoveryConfiguration,
      "Name" : String,
      "Tags" : [ Tag, ... ]
    }
}

YAML

Type: AWS::AgentRegistry::Registry
Properties:
  ApprovalConfiguration: 
    ApprovalConfiguration
  AuthorizerType: String
  Description: String
  DiscoveryConfiguration: 
    DiscoveryConfiguration
  Name: String
  Tags: 
    - Tag

Properties

ApprovalConfiguration

The configuration for the registry's record approval workflow. It controls whether submitted records require manual review before becoming discoverable, or are automatically approved.

Required: No

Type: ApprovalConfiguration

Update requires: No interruption

AuthorizerType

The type of authorizer that controls how consumers access the registry's search and MCP invoke operations.

Required: No

Type: String

Allowed values: CUSTOM_JWT | AWS_IAM

Update requires: Replacement

Description

The description of the registry.

Required: No

Type: String

Minimum: 1

Maximum: 4096

Update requires: No interruption

DiscoveryConfiguration

The discovery configuration for the registry. It controls how consumers are authorized to search the registry and invoke its MCP endpoint.

Required: No

Type: DiscoveryConfiguration

Update requires: No interruption

Name

The name of the registry.

Required: Yes

Type: String

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_\-\.\/]*$

Minimum: 1

Maximum: 64

Update requires: No interruption

Tags

A list of key-value pairs that contain metadata for the registry. For more information, see Tagging Amazon resources in the Amazon General Reference Guide.

Required: No

Type: Array of Tag

Maximum: 50

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns

The Amazon Resource Name (ARN) of the registry.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

CreatedAt

The timestamp when the registry was created.

RegistryArn

The Amazon Resource Name (ARN) of the registry.

RegistryId

The unique identifier of the registry.

Status

The current status of the registry.

UpdatedAt

The timestamp when the registry was last updated.