> ## 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.

# List agents

> List all registered and discovered agents. Optionally enrich with health checks, capabilities, and property summaries via query parameters.



## OpenAPI

````yaml https://raw.githubusercontent.com/adcontextprotocol/adcp/v3.0.26/static/openapi/registry.yaml get /api/registry/agents
openapi: 3.1.0
info:
  title: AgenticAdvertising.org Registry API
  description: >-
    REST API for the AgenticAdvertising.org registry. Resolve brands,

    discover properties, look up agents, and validate authorization in the

    AdCP ecosystem.


    Most endpoints are public and require no authentication. Endpoints marked

    with a lock icon accept either an organization API key or a user JWT

    obtained via the OAuth 2.1 flow — see
    [Authentication](https://agenticadvertising.org/docs/registry/index#authentication).


    **Base URL:** `https://agenticadvertising.org`
  version: 1.0.0
  contact:
    name: AgenticAdvertising.org
    url: https://agenticadvertising.org
servers:
  - url: https://agenticadvertising.org
    description: Production
security: []
tags:
  - name: Brand Resolution
    description: Resolve advertiser domains to canonical brand identities.
  - name: Property Resolution
    description: >-
      Resolve publisher domains to their property configurations and authorized
      agents.
  - name: Agent Discovery
    description: >-
      Browse the federated agent network, search agent inventory profiles,
      publisher index, and registry statistics.
  - name: Change Feed
    description: Poll cursor-based registry change events for local sync.
  - name: Lookups & Authorization
    description: >-
      Look up agents by domain or property, and validate ad-serving
      authorization.
  - name: Validation Tools
    description: >-
      Validate publisher adagents.json files and generate compliant
      configurations.
  - name: Search
    description: Cross-entity search across brands, publishers, agents, and properties.
  - name: Agent Probing
    description: >-
      Connect to live agents and inspect their capabilities, formats, and
      inventory.
  - name: Brand Discovery
    description: Discover and crawl brand.json files across domains.
  - name: Agent Compliance
    description: Agent compliance status, storyboard test results, and compliance history.
  - name: Policy Registry
    description: >-
      Browse, resolve, and contribute governance policies for campaign
      compliance.
paths:
  /api/registry/agents:
    get:
      tags:
        - Agent Discovery
      summary: List agents
      description: >-
        List all registered and discovered agents. Optionally enrich with health
        checks, capabilities, and property summaries via query parameters.
      operationId: listAgents
      parameters:
        - schema:
            type: string
            enum:
              - brand
              - rights
              - measurement
              - governance
              - creative
              - sales
              - buying
              - signals
              - unknown
          required: false
          name: type
          in: query
        - schema:
            type: string
            enum:
              - 'true'
          required: false
          name: health
          in: query
        - schema:
            type: string
            enum:
              - 'true'
          required: false
          name: capabilities
          in: query
        - schema:
            type: string
            enum:
              - 'true'
          required: false
          name: properties
          in: query
        - schema:
            type: string
            enum:
              - 'true'
          required: false
          name: compliance
          in: query
      responses:
        '200':
          description: Agent list
          content:
            application/json:
              schema:
                type: object
                properties:
                  agents:
                    type: array
                    items:
                      $ref: '#/components/schemas/FederatedAgentWithDetails'
                  count:
                    type: integer
                  sources:
                    type: object
                    properties:
                      registered:
                        type: integer
                      discovered:
                        type: integer
                    required:
                      - registered
                      - discovered
                required:
                  - agents
                  - count
                  - sources
components:
  schemas:
    FederatedAgentWithDetails:
      type: object
      properties:
        url:
          type: string
        name:
          type: string
        type:
          type: string
          enum:
            - brand
            - rights
            - measurement
            - governance
            - creative
            - sales
            - buying
            - signals
            - unknown
        protocol:
          type: string
          enum:
            - mcp
            - a2a
        description:
          type: string
        mcp_endpoint:
          type: string
        contact:
          type: object
          properties:
            name:
              type: string
            email:
              type: string
            website:
              type: string
          required:
            - name
            - email
            - website
        added_date:
          type: string
        source:
          type: string
          enum:
            - registered
            - discovered
        member:
          type: object
          properties:
            slug:
              type: string
            display_name:
              type: string
        discovered_from:
          type: object
          properties:
            publisher_domain:
              type: string
            authorized_for:
              type: string
        health:
          $ref: '#/components/schemas/AgentHealth'
        stats:
          $ref: '#/components/schemas/AgentStats'
        capabilities:
          $ref: '#/components/schemas/AgentCapabilities'
        compliance:
          $ref: '#/components/schemas/AgentCompliance'
        publisher_domains:
          type: array
          items:
            type: string
        property_summary:
          $ref: '#/components/schemas/PropertySummary'
      required:
        - url
        - name
        - type
    AgentHealth:
      type: object
      properties:
        online:
          type: boolean
        checked_at:
          type: string
        response_time_ms:
          type: number
        tools_count:
          type: integer
        resources_count:
          type: integer
        error:
          type: string
      required:
        - online
        - checked_at
    AgentStats:
      type: object
      properties:
        property_count:
          type: integer
        publisher_count:
          type: integer
        publishers:
          type: array
          items:
            type: string
        creative_formats:
          type: integer
    AgentCapabilities:
      type: object
      properties:
        tools_count:
          type: integer
        tools:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              description:
                type: string
            required:
              - name
              - description
        standard_operations:
          type: object
          properties:
            can_search_inventory:
              type: boolean
            can_get_availability:
              type: boolean
            can_reserve_inventory:
              type: boolean
            can_get_pricing:
              type: boolean
            can_create_order:
              type: boolean
            can_list_properties:
              type: boolean
          required:
            - can_search_inventory
            - can_get_availability
            - can_reserve_inventory
            - can_get_pricing
            - can_create_order
            - can_list_properties
        creative_capabilities:
          type: object
          properties:
            formats_supported:
              type: array
              items:
                type: string
            can_generate:
              type: boolean
            can_validate:
              type: boolean
            can_preview:
              type: boolean
          required:
            - formats_supported
            - can_generate
            - can_validate
            - can_preview
      required:
        - tools_count
    AgentCompliance:
      type: object
      properties:
        status:
          type: string
          enum:
            - passing
            - degraded
            - failing
            - unknown
        lifecycle_stage:
          type: string
          enum:
            - development
            - testing
            - production
            - deprecated
        tracks:
          type: object
          additionalProperties:
            type: string
          example:
            core: pass
            products: fail
        streak_days:
          type: integer
        last_checked_at:
          type:
            - string
            - 'null'
        headline:
          type:
            - string
            - 'null'
        monitoring_paused:
          type: boolean
        check_interval_hours:
          type: integer
      required:
        - status
        - lifecycle_stage
        - tracks
        - streak_days
        - last_checked_at
        - headline
    PropertySummary:
      type: object
      properties:
        total_count:
          type: integer
        count_by_type:
          type: object
          additionalProperties:
            type: integer
        tags:
          type: array
          items:
            type: string
        publisher_count:
          type: integer
      required:
        - total_count
        - count_by_type
        - tags
        - publisher_count

````