ADadcontextprotocol
Agent Discovery

List agents

Changed on

List all agents in the registry. Optionally enrich with health checks, capabilities, and property summaries via query parameters. Measurement-vendor filters (metric_id, accreditation, q) imply type=measurement. Canonical creative-capability filters (format_kind, publisher_domain, format_option_id, capability_id, creative_operation) match any endpoint exposing that creative surface, including mixed sales/creative agents; add an explicit type only to narrow by primary registry classification.

get/api/registry/agents

Request

  • Base URL
    https://agenticadvertising.org
  • URL
    https://agenticadvertising.org/api/registry/agents
  • Auth
    none required

Query parameters

type'brand' | 'rights' | 'measurement' | 'governance' | 'creative' | 'sales' | 'buying' | 'signals' | 'unknown'
health'true'
capabilities'true'
properties'true'
compliance'true'
string
OR
string[]
string
OR
string[]
qstring

Measurement-vendor filter: case-insensitive substring match against measurement.metrics[].metric_id. v1 scope: metric_id only (description/standard search is a follow-up). Max 64 chars; SQL wildcard characters are escaped. Implies type=measurement.

Example:attention
string
OR
string[]
publisher_domainstring

Canonical creative-capability filter: exact publisher_domain on the same supported-format entry. Pair with format_option_id to find endpoints claiming an exact publisher format.

Example:shorts.streamhaus.example
format_option_idstring

Canonical creative-capability filter: exact publisher format_option_id on the same supported-format entry.

Example:spotlight_video
capability_idstring

Canonical creative-capability filter: exact endpoint-local creative.supported_formats[].capability_id.

'build' | 'validate' | 'preview'
OR
string[]
verification_modestring[]

Filter to agents whose active badge covers the given verification axis. Repeat the parameter for AND semantics: ?verification_mode=spec&verification_mode=live returns only agents verified on both axes.

verified'true'

When true, filter to agents that hold any active verification badge.

Response

Agent list

countinteger required

Example response

{
  "agents": [
    {
      "compliance": {
        "tracks": {
          "core": "pass",
          "products": "fail"
        }
      }
    }
  ]
}

Changes

  • 7b7f2a79e874Revision changes
    • info

      added the optional property /// to the response with the status

  • c8c5f00c15d1Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      removed the measurement enum value from the //// response property for the response status