Agent Registry MCP record creation fails silently on server.json schema constraints

Tried creating an MCP server record in AWS Agent Registry and kept getting Schema validation failed: content is not in compliance with schema version. The Minimal valid example in the docs looked right, but it wouldn't pass.

The issue is that Agent Registry validates against the MCP Registry server.json schema, which has constraints not mentioned in the Agent Registry docs:

name must be reverse-DNS format (pattern: ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$). weather-api fails, io.example/weather-api works
description is limited to 100 characters (maxLength: 100). Exceeding it silently fails validation
schemaVersion is required. Omitting it gives does not match any supported version

Working command:

Terminal

aws bedrock-agentcore-control create-registry-record \
  --registry-id "<registry-id>" \
  --name "weather-api" \
  --record-version "1.0.0" \
  --descriptor-type MCP \
  --descriptors '{
    "mcp": {
      "server": {
        "schemaVersion": "2025-07-09",
        "inlineContent": "{\"name\": \"io.example/weather-api\", \"description\": \"Weather data and forecast service\", \"version\": \"1.0.0\"}"
      }
    }
  }' \
  --region ap-northeast-1

The error message only says content is not in compliance with schema version without indicating which field is wrong. Reading the schema JSON directly is the most reliable way to debug.

Full verification in Hands-on with AWS Agent Registry.