Creates a new registry record within the specified registry¶

Description¶

Creates a new registry record within the specified registry. A registry record represents an individual AI resource's metadata in the registry. This could be an MCP server (and associated tools), A2A agent, agent skill, or a custom resource with a custom schema.

The record is processed asynchronously and returns HTTP 202 Accepted.

Usage¶

bedrockagentcorecontrol_create_registry_record(registryId, name,
  description, descriptorType, descriptors, recordVersion,
  synchronizationType, synchronizationConfiguration, clientToken)

Arguments¶

• registryId

  [required] The identifier of the registry where the record will be created. You can specify either the Amazon Resource Name (ARN) or the ID of the registry.

• name

  [required] The name of the registry record.

• description

  A description of the registry record.

• descriptorType

  [required] The descriptor type of the registry record.

  • MCP - Model Context Protocol descriptor for MCP-compatible servers and tools.
  • A2A - Agent-to-Agent protocol descriptor.
  • CUSTOM - Custom descriptor type for resources such as APIs, Lambda functions, or servers not conforming to a standard protocol.
  • AGENT_SKILLS - Agent skills descriptor for defining agent skill definitions.

• descriptors

  The descriptor-type-specific configuration containing the resource schema and metadata. The structure of this field depends on the descriptorType you specify.

• recordVersion

  The version of the registry record. Use this to track different versions of the record's content.

• synchronizationType

  The type of synchronization to use for keeping the record metadata up to date from an external source. Possible values include FROM_URL and NONE.

• synchronizationConfiguration

  The configuration for synchronizing registry record metadata from an external source, such as a URL-based MCP server.

• clientToken

  A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.

Value¶

A list with the following syntax:

list(
  recordArn = "string",
  status = "DRAFT"|"PENDING_APPROVAL"|"APPROVED"|"REJECTED"|"DEPRECATED"|"CREATING"|"UPDATING"|"CREATE_FAILED"|"UPDATE_FAILED"
)

Request syntax¶

svc$create_registry_record(
  registryId = "string",
  name = "string",
  description = "string",
  descriptorType = "MCP"|"A2A"|"CUSTOM"|"AGENT_SKILLS",
  descriptors = list(
    mcp = list(
      server = list(
        schemaVersion = "string",
        inlineContent = "string"
      ),
      tools = list(
        protocolVersion = "string",
        inlineContent = "string"
      )
    ),
    a2a = list(
      agentCard = list(
        schemaVersion = "string",
        inlineContent = "string"
      )
    ),
    custom = list(
      inlineContent = "string"
    ),
    agentSkills = list(
      skillMd = list(
        inlineContent = "string"
      ),
      skillDefinition = list(
        schemaVersion = "string",
        inlineContent = "string"
      )
    )
  ),
  recordVersion = "string",
  synchronizationType = "URL",
  synchronizationConfiguration = list(
    fromUrl = list(
      url = "string",
      credentialProviderConfigurations = list(
        list(
          credentialProviderType = "OAUTH"|"IAM",
          credentialProvider = list(
            oauthCredentialProvider = list(
              providerArn = "string",
              grantType = "CLIENT_CREDENTIALS",
              scopes = list(
                "string"
              ),
              customParameters = list(
                "string"
              )
            ),
            iamCredentialProvider = list(
              roleArn = "string",
              service = "string",
              region = "string"
            )
          )
        )
      )
    )
  ),
  clientToken = "string"
)