Skip to main content
open_advertisers_page launches Advertisers — the buyer starting point. The Page lists every advertiser on the account with its campaign and draft counts, its brand identity, and one next action, and opening a row switches into that advertiser’s Campaigns Page. ”+ Add advertiser” launches the Advertiser Setup Task. Each advertiser row also has a Settings action. It opens Advertiser settings, the same Advertiser Setup Task in edit mode, for that advertiser: its status, its details, and, in a Media Company account, its client access. You can reach the same Task from the pencil beside an advertiser in the left rail and from the Media Partners Page. Settings does not open the advertiser’s Campaigns Page. A row has a Settings action only when Apostra marks its settings available: in a Media Company account that is House and Self-serve rows, never System or partner-managed rows. Use the Dimensions multi-select in the filter row to filter advertisers by account-defined labels. Values are named by dimension, such as Market › US, and selected values appear as chips inside the control. Advertiser labels on a row are read-only. Opening a row switches to Campaigns, and Advertiser settings does not edit labels. Ask in chat to create a dimension or to label advertisers, especially in bulk. It is a widget launcher: the tool takes one optional argument, intent (see below), returns the shared MCP App directive for ui://agentic-api/all-advertisers-home/mcp-app.html, and the Page self-fetches its landing projection through the app-only V3 get_buyer_advertisers_page tool. Nothing about the advertisers enters model context. The Page changes nothing itself: its filters narrow the list, and Add advertiser and Settings launch the Advertiser Setup Task, which does the saving. System advertiser rows remain read-only. Every buyer can open Advertisers and then continue to the Campaigns Page.

From an agent (MCP)

Ask in natural language — “show my advertisers”, “list advertisers”, or “where do I start” — and the agent calls the tool on /mcp/v3:
The result carries content (Opened Advertisers Page.), an empty structuredContent, and the resource directive. A host that renders MCP Apps opens the Page; any other host receives the text.

Add an advertiser

Ask to add or set up an advertiser and the agent passes intent: "add":
The Page opens and then the Advertiser Setup Task, exactly as if you had selected Add advertiser. The agent does not collect the advertiser’s name, domain, currency, or markets in chat: the form collects them, and you confirm and submit it. The form applies the same rules as the button, so any limit on live advertisers, such as sandbox-only until your company’s identity is confirmed in Buyer Setup, still applies and the Page still shows its notice. The result carries structuredContent of { "intent": "add" }, and add is the only accepted intent.

Text answers

For an answer in words rather than a Page — a count, a name, a status — use search(kind: "advertiser") and get(kind: "advertiser", id) instead. The launcher never recites the list.

Errors