# Agent Offer Network (AON) Developer Documentation

> AON Docs explains how Developers and Partners build with AON. Agent Offer Network (AON) is a structured offer network for AI commerce that connects AI product builders with merchant offers and preserves attribution from click to qualified outcome. AgentOffer Protocol is the public technical specification used by AON for offer discovery and attribution.

Entity disambiguation: In AON Docs, AON and aon.pro refer only to Agent Offer Network, a structured offer network for AI commerce. They do not refer to Aon plc, AONDevices or AONx360, AGI Open Network, Aon Pro Studio, or other similarly named entities.

## Site role and authority

- [AON Docs home](https://docs.aon.pro/): Use this site for deployed AON integration paths, APIs, SDKs, hosted MCP, Partner supply, and operational guidance.
- [AON website](https://www.aon.pro/): Use the official website to understand what AON is, who it serves, and how it connects AI products with structured merchant offers and reported outcomes.
- [AgentOffer Protocol website](https://agentoffernetwork.org/): Use the protocol website to inspect the public technical specification used by AON for offer discovery and attribution; AON remains the service and brand for AI-native commerce.
- [Canonical protocol sources](https://github.com/agentoffernetwork): Use the GitHub organization for exact specifications, schemas, examples, and RFC proposals.

Every indexed documentation page below is available as HTML and as same-path Markdown. Each description states the page's purpose so agents can choose the narrowest authoritative source.

## Start here

- [AON Quick Start](https://docs.aon.pro/quickstart): Choose the supported REST API, SDK, or provisioned MCP path for a new AON integration. [Markdown](https://docs.aon.pro/quickstart.md)
- [Public Test Sandbox](https://docs.aon.pro/quickstart/public-test-sandbox): Run a bounded, non-billable Offer Query against fixed samples before requesting production access. [Markdown](https://docs.aon.pro/quickstart/public-test-sandbox.md)

## Build with REST or SDK

- [Your first API call](https://docs.aon.pro/quickstart/first-api-call): Send and validate a first versioned Offer Query API request. [Markdown](https://docs.aon.pro/quickstart/first-api-call.md)
- [SDK implementation](https://docs.aon.pro/quickstart/sdk-setup): Install and configure the current TypeScript SDK after validating the API contract. [Markdown](https://docs.aon.pro/quickstart/sdk-setup.md)
- [Get your Placement ID](https://docs.aon.pro/quickstart/get-api-key): Get the placement id that identifies your live Offer Query and MCP traffic. [Markdown](https://docs.aon.pro/quickstart/get-api-key.md)

## Hosted MCP

- [AON MCP](https://docs.aon.pro/mcp): Decide whether AON's hosted MCP tool surface is the right integration route for an AI client. [Markdown](https://docs.aon.pro/mcp.md)
- [MCP Quick Start](https://docs.aon.pro/mcp/quickstart): Connect an MCP-compatible client with your placement id and run the first offer search. [Markdown](https://docs.aon.pro/mcp/quickstart.md)
- [MCP Tools Reference](https://docs.aon.pro/mcp/tools): Reference AON MCP tool names, arguments, outputs, and private extensions. [Markdown](https://docs.aon.pro/mcp/tools.md)
- [MCP Usage Guide](https://docs.aon.pro/mcp/guide): Implement multi-turn offer discovery, guidance loops, session continuity, and tolerant degradation. [Markdown](https://docs.aon.pro/mcp/guide.md)
- [MCP Rate Limits & FAQ](https://docs.aon.pro/mcp/faq): Check MCP authentication, rate limits, endpoint status, and common integration questions. [Markdown](https://docs.aon.pro/mcp/faq.md)

## Host integrations

- [Guides](https://docs.aon.pro/guides): Find task-oriented guidance after choosing an integration path in Quick Start. [Markdown](https://docs.aon.pro/guides.md)
- [Core Concepts](https://docs.aon.pro/guides/core-concepts): Understand how user intent, Offer Query, structured offers, actions, and optional events fit together. [Markdown](https://docs.aon.pro/guides/core-concepts.md)
- [Content Assistant](https://docs.aon.pro/guides/content-assistant): Add the AON Content Assistant to a page: pick styles in the Developer Portal, drop in the snippet, and mark where the inline placements appear. [Markdown](https://docs.aon.pro/guides/content-assistant.md)
- [Offer Wall](https://docs.aon.pro/guides/offer-wall): Show an Offer Wall placement with the hosted page or the Offer Query API, page through offers, and attribute conversions with sub_id. [Markdown](https://docs.aon.pro/guides/offer-wall.md)
- [Host Integrations](https://docs.aon.pro/guides/integration): Choose implementation guidance for Claude or command-line workflows. [Markdown](https://docs.aon.pro/guides/integration.md)
- [Claude Integration](https://docs.aon.pro/guides/integration/claude): Connect Claude or another MCP-compatible workflow to AON offer discovery. [Markdown](https://docs.aon.pro/guides/integration/claude.md)
- [CLI Tool Reference](https://docs.aon.pro/guides/integration/cli): Test Offer Query requests, mock responses, and tracked destinations from the command line. [Markdown](https://docs.aon.pro/guides/integration/cli.md)
- [Best Practices](https://docs.aon.pro/guides/best-practices): Apply current guidance for intent, structured-offer presentation, disclosure, location, and recovery. [Markdown](https://docs.aon.pro/guides/best-practices.md)

## API and SDK reference

- [API Reference](https://docs.aon.pro/api): Navigate Developer-facing AON endpoints and their authentication and reliability contracts. [Markdown](https://docs.aon.pro/api.md)
- [Offer Query](https://docs.aon.pro/api/offer-query): Reference the request and response contract for intent-based offer discovery. [Markdown](https://docs.aon.pro/api/offer-query.md)
- [Location Search](https://docs.aon.pro/api/location-search): Resolve country, region, and city signals to canonical identifiers used by AON. [Markdown](https://docs.aon.pro/api/location-search.md)
- [OfferInfo API](https://docs.aon.pro/api/offer-info): Read current public Offer details and lifecycle status by canonical offer_id using a Live API Key. [Markdown](https://docs.aon.pro/api/offer-info.md)
- [Offer Instance API](https://docs.aon.pro/api/offer-instances): Look up Offer cards your application was served by offer_instance_id with a Live API Key: served time, placement, current details and status, and the original tracked link while it can be opened. [Markdown](https://docs.aon.pro/api/offer-instances.md)
- [Reporting API](https://docs.aon.pro/api/reporting): Retrieve outcome and earnings reporting and understand completeness and migration behavior. [Markdown](https://docs.aon.pro/api/reporting.md)
- [Webhook Protocol v1.0](https://docs.aon.pro/api/webhooks): Verify and process signed AON conversion Webhooks with idempotent delivery handling. [Markdown](https://docs.aon.pro/api/webhooks.md)
- [aon.js Web Plugin](https://docs.aon.pro/api/web-plugin): Reference the aon.js script tag, end-of-content spot, page requirements, requests, and window.AON API for Content Assistant placements. [Markdown](https://docs.aon.pro/api/web-plugin.md)
- [SDK Reference](https://docs.aon.pro/sdk): Choose the current TypeScript SDK reference. [Markdown](https://docs.aon.pro/sdk.md)
- [TypeScript SDK Reference](https://docs.aon.pro/sdk/typescript): Reference TypeScript client setup, methods, types, configuration, and tracking fields. [Markdown](https://docs.aon.pro/sdk/typescript.md)

## Protocol

- [AgentOffer Protocol](https://docs.aon.pro/protocol): Understand the current AgentOffer Protocol v1.0 contract and locate its canonical specifications and schemas. [Markdown](https://docs.aon.pro/protocol.md)
- [Category Taxonomy](https://docs.aon.pro/protocol/category-taxonomy): Use canonical category identifiers for Offer classification and Query constraints. [Markdown](https://docs.aon.pro/protocol/category-taxonomy.md)
- [Location Targeting](https://docs.aon.pro/protocol/location-targeting): Apply canonical location identifiers and targeting rules to offer eligibility. [Markdown](https://docs.aon.pro/protocol/location-targeting.md)

## Partner integration

- [Supply offers to AON with Protocol v1.0](https://docs.aon.pro/partner): Choose the Partner path for supplying offers to AON and reporting attributable outcomes. [Markdown](https://docs.aon.pro/partner.md)
- [Partner Portal setup](https://docs.aon.pro/partner/portal-setup): Configure Partner Portal access, offer sources, credentials, and initial integration settings. [Markdown](https://docs.aon.pro/partner/portal-setup.md)
- [Credentials & signing](https://docs.aon.pro/partner/credentials-signing): Authenticate AON Offer Fetch requests and manage signing secrets and rotation. [Markdown](https://docs.aon.pro/partner/credentials-signing.md)
- [Implement Offer Fetch with Protocol v1.0](https://docs.aon.pro/partner/offer-fetch): Implement the signed Partner Offer Fetch contract that returns eligible supply to AON. [Markdown](https://docs.aon.pro/partner/offer-fetch.md)
- [Postbacks & attribution](https://docs.aon.pro/partner/postbacks): Report and reverse conversions to AON with GET postbacks while preserving attribution and validation fields. [Markdown](https://docs.aon.pro/partner/postbacks.md)
- [Tracking Macros](https://docs.aon.pro/partner/tracking-macros): Insert AON tracking identifiers into Partner landing URLs safely. [Markdown](https://docs.aon.pro/partner/tracking-macros.md)

## Updates

- [Changelog](https://docs.aon.pro/changelog): Review user-visible Protocol and documentation changes that can affect an integration. [Markdown](https://docs.aon.pro/changelog.md)