Optimon AI connector
Last updated: 19 Nov 2026
The Optimon connector brings Optimon's analysis into Claude or ChatGPT. You ask in plain words, for example "why was revenue down yesterday?", and your AI answers from Optimon: your Google Ad Manager and Prebid data with its history, pricing rules and their floor history, alerts and Optimon's own checks, with the rows behind each number. Alerts, the daily briefing and pricing-rules work stay in the Optimon dashboard. Setup steps and questions to copy are on Optimon in Claude and ChatGPT. For help, see Support.
Connector address and who can use it
Address: https://mcp.optimon.io/mcp. It is a remote MCP server over Streamable HTTP. It works with Claude (claude.ai and the Claude desktop app, as a custom connector) and with ChatGPT on the web (as a custom MCP server). You need an Optimon dashboard login with AI access switched on for your user; Optimon switches it on. The publisher account also needs Optimon AI on.
Sign-in and access
- OAuth 2.1 with dynamic client registration and PKCE (S256 only). You sign in on publishers.optimon.io with your usual Optimon login and click Allow. The connector never sees your password or login code.
- Access tokens last one hour. Refresh tokens last 30 days and change on every use; using an old one again ends the connection.
- Tokens and codes are stored only as one-way (SHA-256) hashes.
- Every request checks your user again. If AI access is switched off for you, the connection stops on its next request.
- The account comes from your login on every call, so your AI reads only the publishers you see in the dashboard. An agency login names which of its publishers it means.
- To disconnect, remove Optimon in your AI app's connector settings. To switch AI access off for a user, write to hello@optimon.io.
Tools
Read tools. They change nothing. Optimon never writes to Google Ad Manager. Tools follow your account: a publisher without Prebid analytics, GA4 or Site Audit in Optimon gets no data from those tools.
| Tool | What it does |
|---|---|
list_publishers | The publisher accounts this connection can read (agency and multi-account logins) |
describe_account | What data the account has, the dates covered, currency, time zone, and the ids of ad units, pricing rules, sites and bidders |
kpis | Revenue, impressions, ad requests, CPM and fill rate for a date range, with an optional comparison and daily rows |
breakdown | Every row of one dimension (demand source, device, country, ad unit, pricing rule, bidder and more), compared |
movers | What rose and fell between two periods, and what is new or gone |
alerts | Optimon alerts: revenue and fill drops, pricing rule issues, Prebid health, ads.txt changes |
pricing_rules | Google Ad Manager pricing rules with revenue, CPM, fill and the floor history Optimon logged |
prebid | Prebid analytics: bidders, response times, win rates and incremental value |
traffic | GA4 page views, sessions and users per day and device |
site_audit | Optimon Site Audit score, history and issues per site |
query | A structured query over Optimon's entities and metrics when no other tool fits |
optimon_insights | What Optimon's engine flags: open alerts, floor suggestions, biggest moves |
consult | Optimon's rule-based checks (floors against demand, fill against CPM, bidder health, ads.txt) with evidence rows |
suggest_floor | Optimon's suggested floor for one pricing rule, the evidence, and a link to that rule in Ad Manager |
Two write tools, shown only to users with floor work switched on. They change Optimon's own event log, never Ad Manager.
| Tool | What it does |
|---|---|
record_floor_change | After you changed a floor in Ad Manager yourself, logs that change in Optimon. Preview first, then your confirmation; a change of more than 50% is refused |
undo_floor_record | Removes a floor-change record you made in the last 7 days. Preview first, then your confirmation |
Prompts
Five named prompts. Each tells your AI which Optimon tools to call and how to write the answer.
| Tool | What it does |
|---|---|
weekly_review | Weekly review |
revenue_change | Why did revenue move |
floor_check | Floor check |
prebid_health | Prebid health |
consult | Ask Optimon's playbook |
What data the connector reads
Only what a tool call asks for, from the publishers your login can see: revenue, impressions, ad requests, CPM and fill by ad unit, demand source, device, country and request type; alerts including ads.txt; pricing rules and their floor history; Prebid analytics, GA4 traffic and Site Audit results where your account has them. The results go to the AI app that made the call, and Anthropic or OpenAI handle them under their own terms. Optimon runs no AI model for the connector and does not receive your conversation with the AI, only the tool calls.
What we log
- Every tool call, with the user (id, email and role), the publisher, the AI app that made it, the tool, a one-way hash of its parameters (never the parameters themselves), whether it worked, how many rows it returned, its size and how long it took.
- Floor changes you ask the AI to record are kept in your Optimon event log, like changes logged in the dashboard.
- Sign-in requests, deleted an hour after they expire.
How long we keep it
- Raw call logs: 12 months, then deleted. After that we keep only aggregate usage counts.
- Connection records: deleted a day after the last token they hold expires.
We do not sell this data, and we do not use your data to train AI models. The full terms are in the privacy policy.