Skip to main content

Listing Metadata

listing_metadata is the public description layer for your listing. Good metadata helps agents discover and reason about your API without needing provider-specific docs first.

Good public metadata

  • operation names
  • default operation
  • input schema hints
  • output schema hints
  • tags
  • cost hints
  • latency hints

Good example

Do not place these fields in listing metadata

  • secrets
  • internal provider credentials
  • operator notes
  • private infrastructure details
  • internal settlement assumptions
Think of listing_metadata as a public contract supplement, not a private runbook.