Govern and discover records with common metadata in AWS Agent Registry Amazon Web Services added custom metadata schemas to AWS Agent Registry, letting administrators define organization-wide key-value fields that every registered agent, MCP server, and skill record must carry. Records created without custom metadata are saved as NON_COMPLIANT and cannot be submitted for approval, while records with unknown fields, missing required fields, or invalid values are rejected with a ValidationException; GetRegistryRecord returns each record's metadata values and compliance status, and discovery APIs can filter on custom attributes. The feature gives governance teams, publishers, approvers, and agents a shared vocabulary for attributes such as business units, resource owners, risk classifications, and development environments. Artificial Intelligence https://aws.amazon.com/blogs/machine-learning/ Govern and discover records with common metadata in AWS Agent Registry As organizations build more agents, Model Context Protocol MCP servers and skills, they need a consistent way to describe, govern, and find them. AWS Agent Registry https://aws.amazon.com/blogs/machine-learning/manage-agents-tools-and-skills-at-scale-with-aws-agent-registry/ provides a catalog for registering, approving, and discovering these resources and custom records. Each record carries a name, a description, a protocol descriptor, and an approval status. However, every organization has attributes and facts that it wants to track, and some are unique to that organization, such as its business units, resource owners, risk classifications, and development environments. Organizations want one common definition for each of these attributes, and they want every agent, MCP server, and skill in the registry to carry these facts. Until now, organizations had no way to define these facts in AWS Agent Registry and store them on each record. Custom metadata schemas are now available in AWS Agent Registry. A custom metadata schema is a set of organization-defined key-value pairs that records in an AWS Agent Registry carry. An administrator defines the schema and applies it to the registry, and all records within the registry must then adhere to the schema. When publishers create or submit records, they supply values for the fields specified in the applicable schema, and AWS Agent Registry validates those values against the schema set by the admin. Approvers can rely on the validated values when reviewing a record, and consumers and agents can use them to discover and filter records. Administrators, publishers, security and governance teams, approvers, consumers, and agents all work from a shared set of facts to govern, discover, and understand the resources in their agentic fleet. In this post, we follow the AnyCompany organization publishing an MCP server with custom schema definition, enriching that record, and making it available for discovery by humans or agents. We use an MCP server as the example, but the same steps apply to other record types. How custom metadata works With custom metadata, an organization can use standardized vocabulary for describing its resources. The registry administrator defines the custom metadata schema https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-custom-metadata-schema.html : field names, types, allowed values, and whether each field is required or optional. The registry enforces the schema on every record, so a field such as environment has the same name and the same allowed values whichever team publishes the record. The schema has common attributes that apply to every record type, and you can add dedicated fields that only apply to specific record types. Each field is Text, Enum, URL, or Boolean. - When a record is created or updated, the registry validates the custom metadata against the schema set up by the admin. - If a record is created without any custom metadata, AWS Agent Registry saves it as NON COMPLIANT . A team can save work in progress this way, but it can’t submit the record for approval until it has the required fields and values. - If a record includes custom metadata with an unknown field, a missing required field, or an invalid value, AWS Agent Registry rejects it with a ValidationException . - - GetRegistryRecord returns the record’s custom metadata values and its compliance status. COMPLIANT means that the values match the administrator’s schema. It is not an approval. The approvers make that decision. - Discovery APIs also allow filtering records based on custom attributes. What custom metadata makes possible Because teams can describe the AWS Agent Registry records with the same fields and values, the registry can support and scale governance and compliance. Ownership and operations Fields such as environment prod , staging , or dev , businessUnit , ownerTeam , supportContact , and costCenter record where a resource runs, who is responsible for it, and who pays for it. A configuration management database CMDB ID links the record to your existing inventory, and a support-tier field sets expectations for anyone who depends on the resource. Security and compliance Data classification, compliance scope such as Payment Card Industry PCI or Health Insurance Portability and Accountability Act HIPAA , risk tier, scan status, and a scan report URL turn an approval into a check of structured evidence. Your existing scanners, CMDB sync jobs, and classification tools write these values through the API before a record is submitted. You can build your record approval process or automation using these values, as this post shows. Better discovery Custom metadata values are indexed for search. A consumer or agent can combine a natural-language query with specific metadata filters, such as environment=prod AND businessUnit=payments AND securityScanStatus=PASSED . Only approved records are returned, so a record that matches the filters but hasn’t been approved stays out of the results. Figure 1 shows how each role, from administrator to consumer, moves a record through schema definition, registration, enrichment, approval, and discovery. Walkthrough of an MCP record from registration to discovery AnyCompany operates anycompany-governed-registry , an AWS Agent Registry without auto-approval. Its payments team publishes an MCP record, payments-ledger-mcp , a read-only server for ledger lookups. Existing security and inventory systems enrich this MCP record before an approval function decides whether consumers can discover it. The five numbered steps in Figure 2 match the walkthrough: define, register, enrich and submit, review, then discover. Prerequisites To follow the walkthrough, you need: - An AWS account in a supported AWS Region https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-regions.html . - AWS credentials available to Boto3 and AWS Identity and Access Management IAM permissions for AWS Agent Registry. - Python 3.11 or later and boto3 1.43.113 or later. - The sample implementation https://github.com/awslabs/agentcore-samples/tree/main/01-features/07-centralize-and-govern-your-ai-infrastructure/03-registry/03-advanced/custom-metadata-in-registry is in the GitHub repo. The snippets are shortened: cp and dp are the agent-registry-control and agent-registry boto3 clients. The sample repository has the complete code. Step 1: AWS Agent Registry admin defines the custom metadata schema for the registry AnyCompany’s admin creates a registry with a custom metadata schema that every record must follow. 1. Every record must have its environment , businessUnit , and securityScanStatus fields. 2. Records can also carry optional fields that the publisher or automation fills in later: ownerTeam , cmdbId , dataClassification , and securityScanReportUrl . 3. MCP servers also record their networkEgress , which is optional. Figure 3 shows this schema and the values payments-ledger-mcp will carry once enrichment completes in Step 3. The empty autoApprovalRules list means that the registry approves nothing on its own. Every submitted record stays in Pending approval until someone or something approves it. You decide whether that is done by automated checks you build Step 4 uses an AWS Lambda function , a human approver, or both. Administrators can also review the schema in the AWS Agent Registry console. Figure 4 shows the common attributes and the MCP-specific field as they appear on the registry’s details page. Step 2: The publisher registers the server The payments team’s pipeline registers payments-ledger-mcp with its custom metadata. Its first attempt uses production instead of one of the administrator’s allowed values. The registry rejects the record. After the pipeline sends prod , the record is created as a compliant draft. This is how the schema keeps every team using the same values. Step 3: Automation adds additional metadata and submits Next, AnyCompany’s automation adds what its own systems know: the result from its security scanner, the asset ID from its CMDB, and the approved data classification. It then submits the record for approval. An update replaces the whole metadata map https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-custom-metadata-values.html , so the automation reads the current values, adds its own, and writes them back together. In the sample, the scanner and CMDB calls are stubs that you replace with your own tools. The registry sends a pending-approval event https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/registry-notifications-approvals.html to Amazon EventBridge. In Step 4, a rule that you create passes the event to your approval function. Step 4: The approval automation decides from the evidence When the record moves to Pending approval, AWS Agent Registry sends an event to Amazon EventBridge, and an Amazon EventBridge rule is set to invoke a custom AWS Lambda function. Figure 5 shows the console view of payments-ledger-mcp , with the custom metadata values that the approval function reads for its check. The function reads the record’s custom metadata and compliance status to check that the record is COMPLIANT , the scan PASSED , a cmdbId is present, and the data is public or internal. payments-ledger-mcp passes all four, so the function approves. A record that fails a check is rejected, and the reason names the failed check. In your production systems, you can choose t