> ## Documentation Index > Fetch the complete documentation index at: https://docs.interchange.io/llms.txt > Use this file to discover all available pages before exploring further. # Discover agents for a domain > Query the agenticadvertising.org registry (with an adagents.json fallback) for the operator and publisher agents authorized for a domain. Server-side cached for 2 minutes; pass refresh=true to bypass. ## OpenAPI ````yaml /v2/storefront-api-v2.yaml get /discover-agents openapi: 3.0.0 info: title: Scope3 Storefront API version: 2.0.0 description: |- REST API for partners to manage storefronts, inventory sources, and billing. ## Authentication All endpoints require a Bearer token in the Authorization header: ``` Authorization: Bearer your-api-key ``` ## Base URL `https://api.interchange.io/api/v2/storefront` ## For AI Agents AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools: - `initialize`: Start an MCP session - `api_call`: Make REST API calls - `ask_about_capability`: Learn about API features servers: - url: https://api.interchange.io/api/v2/storefront description: Production server security: [] tags: - name: Account description: Account management, service tokens, and preferences - name: Asks description: >- What you are waiting on Scope3 for — support, product, and supply asks in one list - name: Storefront description: Manage storefront and inventory sources - name: Storefront Agents description: List and manage registered sales, signals, and outcomes agents - name: Storefront Activity description: Audit log of configuration and inventory changes on the storefront - name: Storefront Billing description: Payout bank details and billing configuration for storefronts - name: AI Usage description: Storefront AI token usage visibility by model - name: MCP description: Model Context Protocol endpoints paths: /discover-agents: get: tags: - Storefront summary: Discover agents for a domain description: >- Query the agenticadvertising.org registry (with an adagents.json fallback) for the operator and publisher agents authorized for a domain. Server-side cached for 2 minutes; pass refresh=true to bypass. operationId: discoverAgents parameters: - in: query name: domain schema: description: Operator domain to discover agents for type: string minLength: 1 required: true description: Operator domain to discover agents for - in: query name: refresh schema: description: Set to "true" to bypass the 2-minute server-side cache and refetch anyOf: - type: string enum: - 'true' - type: string enum: - 'false' description: Set to "true" to bypass the 2-minute server-side cache and refetch responses: '200': description: Discover agents for a domain content: application/json: schema: $ref: '#/components/schemas/DiscoverAgentsResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: DiscoverAgentsResponse: type: object properties: domain: type: string operator: description: Agents registered to this operator domain type: object properties: domain: type: string member: nullable: true type: object properties: slug: type: string display_name: type: string required: - slug - display_name additionalProperties: false agents: type: array items: type: object properties: url: type: string name: type: string type: type: string compliance: type: object additionalProperties: {} storyboards: type: array items: {} authorized_by: type: array items: {} required: - url - name - type additionalProperties: false required: - domain - member - agents additionalProperties: false publisher: description: Publisher record from the AAO registry or the adagents.json fallback type: object properties: domain: type: string member: nullable: true type: object properties: slug: type: string display_name: type: string required: - slug - display_name additionalProperties: false adagents_valid: nullable: true type: boolean discovery_method: description: >- How the live adagents.json was resolved, when one was. `ads_txt_managerdomain` means the domain hosts no file of its own and delegates via its ads.txt managerdomain (e.g. a Raptive/CafeMedia-managed publisher). Absent when no file resolved. type: string enum: - direct - authoritative_location - ads_txt_managerdomain manager_domain: description: >- Manager domain the file was resolved from when `discovery_method` is `ads_txt_managerdomain` (e.g. cafemedia.com); null otherwise. nullable: true type: string resolved_url: description: URL the authoritative adagents.json was actually fetched from. nullable: true type: string properties: type: array items: type: object additionalProperties: {} authorized_agents: type: array items: type: object additionalProperties: {} formats: description: >- The publisher's self-published creative formats (AdCP 3.1 `formats[]`), read through their canonical adagents.json. Present whenever a live adagents.json resolved; absent when only the registry mirror resolved. type: array items: type: object additionalProperties: {} hosting: description: >- The registry's hosting verdict: `mode` (self-hosted / AAO-hosted / redirected / invalid / none) and `last_validated` (last crawl time; null = never crawled). type: object properties: mode: type: string enum: - self - self_invalid - aao_hosted - self_redirected - none last_validated: nullable: true type: string required: - mode - last_validated additionalProperties: false freshness: description: >- Provenance of the authorization verdict. `source: 'registry'` = the registry's crawled verdict stood; `source: 'live_origin'` = the verdict lagged so the publisher's live adagents.json was trusted. `recrawl_requested` marks that a re-crawl was requested to converge the mirror. type: object properties: source: type: string enum: - registry - live_origin registry_adagents_valid: nullable: true type: boolean last_validated: nullable: true type: string recrawl_requested: type: boolean required: - source - registry_adagents_valid - last_validated additionalProperties: false required: - domain - member - adagents_valid - properties - authorized_agents additionalProperties: false required: - domain - operator - publisher additionalProperties: false ErrorResponse: description: Standard error response type: object properties: data: type: string nullable: true enum: - null error: $ref: '#/components/schemas/ApiError' required: - data - error additionalProperties: false ApiError: description: Structured error object type: object properties: code: description: Machine-readable error code type: string message: description: Human-readable error message type: string field: description: Field path associated with the error type: string details: description: Additional error context type: object additionalProperties: {} required: - code - message additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: API key or access token ````