AON — Agent Offer Network

What AON — Agent Offer Network does

AON — Agent Offer Network exposes the Agent Offer Network through MCP so an agent can retrieve actionable offers rather than general web articles. Search results contain real products or services, current pricing, and a tracked destination link that should be shown to the user verbatim.

The service is intended for requests with purchase intent, such as finding a laptop below a budget, comparing team software, or locating a credit card with a particular benefit. It also provides taxonomy assistance and optional category guidance for requests that need clarification before searching.

How it works

The hosted MCP endpoint is available at https://api.aon.pro/v1/mcp. It accepts Streamable HTTP with stateless JSON-RPC 2.0; no SSE connection or session handshake is required. A search call needs an intent.content[0] item containing an input_text value with one natural-language sentence.

Search responses include an array of offers, a request ID, protocol and language fields, and may include follow-up suggestions. A suggestion contains a request patch that can be merged into the next query. Agents should also pass the previous request ID and echo the suggestion origin when continuing that interaction, which helps avoid repeating offers already shown.

Setup and configuration

Use the endpoint directly from an MCP client or with JSON-RPC over HTTP. The repository includes examples for Claude Code, Claude Desktop through mcp-remote, Cursor, and VS Code, as well as a curl example.

For application attribution, create an application and placement in the AON Developer Portal, then send the placement ID in the X-AON-Placement-Id header. The example configuration uses the AON_PLACEMENT_ID environment variable. Omitting the header still permits anonymous searches, but clicks and conversions cannot be attributed to the application.

Tools and capabilities

• aon_search_offers searches by natural-language intent and returns offers with prices, tracked links, and possible follow-up suggestions.
• aon_resolve_category maps free-text descriptions to AON Taxonomy v1 category IDs. It returns up to three candidates with names and match scores.
• aon_get_category_schema is a hosted extension that lists buyer decision factors for a resolved category. Passing all lists categories that currently have a schema.
• aon_submit_feedback accepts an explicit dismissal or “not interested” action for an offer.
• aon_manage_watch accepts explicit requests to restore or cancel a watch for an offer or category.

Use aon_resolve_category before adding a category constraint to a search. Category IDs should come from that tool rather than being guessed.

Limitations and notes

Search is relevance-gated, so an empty offers array is a valid result. Invalid optional values can be corrected and reported in extra.hints[], while malformed requests, missing intent content, oversized bodies, and invalid placement data can fail.

The feedback and watch tools currently acknowledge requests without persisting state or changing delivery. The category schema is an optional hosted extension rather than a portable Protocol v1.0 requirement. Calls are limited to 60 tools/call requests per minute per application; excess calls receive HTTP 429 with a Retry-After header.