Skip to main content
GET
/
api
/
registry
/
agents
List agents
curl --request GET \
  --url https://agenticadvertising.org/api/registry/agents
{
  "agents": [
    {
      "url": "<string>",
      "name": "<string>",
      "description": "<string>",
      "mcp_endpoint": "<string>",
      "contact": {
        "name": "<string>",
        "email": "<string>",
        "website": "<string>"
      },
      "added_date": "<string>",
      "member": {
        "slug": "<string>",
        "display_name": "<string>",
        "membership_tier": "<string>",
        "membership_tier_label": "<string>",
        "is_founding_member": true
      },
      "health": {
        "online": true,
        "checked_at": "<string>",
        "response_time_ms": 123,
        "tools_count": 123,
        "resources_count": 123,
        "error": "<string>"
      },
      "stats": {
        "property_count": 123,
        "publisher_count": 123,
        "publishers": [
          "<string>"
        ],
        "creative_formats": 123
      },
      "capabilities": {
        "tools_count": 123,
        "tools": [
          {
            "name": "<string>",
            "description": "<string>"
          }
        ],
        "standard_operations": {
          "can_search_inventory": true,
          "can_get_availability": true,
          "can_reserve_inventory": true,
          "can_get_pricing": true,
          "can_create_order": true,
          "can_list_properties": true
        },
        "creative_capabilities": {
          "formats_supported": [
            "<string>"
          ],
          "can_generate": true,
          "can_validate": true,
          "can_preview": true
        },
        "signals_capabilities": {
          "audience_types": [
            "<string>"
          ],
          "can_match": true,
          "can_activate": true,
          "can_get_signals": true
        },
        "measurement_capabilities": {
          "metrics": [
            {
              "metric_id": "<string>",
              "standard_reference": "<string>",
              "accreditations": [
                {
                  "accrediting_body": "<string>",
                  "certification_id": "<string>",
                  "valid_until": "<string>",
                  "evidence_url": "<string>"
                }
              ],
              "unit": "<string>",
              "description": "<string>",
              "methodology_url": "<string>",
              "methodology_version": "<string>"
            }
          ]
        }
      },
      "compliance": {
        "tracks": {
          "core": "pass",
          "products": "fail"
        },
        "streak_days": 123,
        "last_checked_at": "<string>",
        "headline": "<string>",
        "monitoring_paused": true,
        "check_interval_hours": 123,
        "verified": true,
        "verified_roles": []
      },
      "publisher_domains": [
        "<string>"
      ],
      "property_summary": {
        "total_count": 123,
        "count_by_type": {},
        "tags": [
          "<string>"
        ],
        "publisher_count": 123
      }
    }
  ],
  "count": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.adcontextprotocol.org/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

type
enum<string>
Available options:
brand,
rights,
measurement,
governance,
creative,
sales,
buying,
signals,
unknown
health
enum<string>
Available options:
true
capabilities
enum<string>
Available options:
true
properties
enum<string>
Available options:
true
compliance
enum<string>
Available options:
true
metric_id

Measurement-vendor filter: exact match on measurement.metrics[].metric_id. Repeatable (each value is OR'd within the param, AND'd with other filters). Implies type=measurement.

Example:

"attention_units"

accreditation

Measurement-vendor filter: exact match on measurement.metrics[].accreditations[].accrediting_body (e.g. MRC, JIC, ARF). Repeatable. Implies type=measurement. Accreditation claims are vendor-asserted; AAO does not independently verify (verified_by_aao is always false in the response).

Example:

"MRC"

q
string

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.

Maximum string length: 64
Example:

"attention"

verification_mode
enum<string>[]

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.

Available options:
spec,
live
verified
enum<string>

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

Available options:
true

Response

Agent list

agents
object[]
required
count
integer
required