# Connect ChatGPT dots to Apogee's MCP server: setup, checks, limits and errors https://www.apogee.ad/developers/mcp/chatgpt-dots/ (Markdown: https://www.apogee.ad/developers/mcp/chatgpt-dots.md). Updated 2026-11-03. ChatGPT dots (the ChatGPT apps [desktop, mobile] and chatgpt.com on a computer) connects to Apogee's MCP server at `https://app.apogee.ad/mcp` with Apogee's sign-in (OAuth). It then works on your Meta, TikTok and Snapchat ad accounts through Apogee's 80 tools: it reads freely, and launches or changes ads only after your explicit yes to a recap. ## At a glance - Server URL: `https://app.apogee.ad/mcp` - Transport: Streamable HTTP, stateless: every request is a `POST` answered with JSON. - Sign-in: Apogee's sign-in (OAuth 2.1 with PKCE): the assistant opens Apogee's page, you log in and click **Authorize**. ChatGPT dots cannot send an API key. - Scopes: **Read** (`read`), **Launch** (`launch`), **Actions** (`actions`): ticked on Apogee's page when ChatGPT dots signs in; untick what it should not do ([scopes](https://www.apogee.ad/developers/authentication/#scopes)). - Apogee plan: [Pro, Growth or Scale](https://www.apogee.ad/en/pricing/) (not Starter) - Server instructions: On connection, Apogee tells ChatGPT dots how to launch: the interview, the recap, your yes ([read them](https://www.apogee.ad/developers/mcp/#instructions)). ## Set it up 1. Add Apogee to ChatGPT: open [chatgpt.com/plugins](https://chatgpt.com/plugins), **+ → Add custom MCP server**, name it Apogee, Server URL `https://app.apogee.ad/mcp`, authentication **OAuth**. 2. Click **I understand and want to continue**, then **Create as a plugin**, check the tools and install it. Log in to Apogee on the page that opens and click **Authorize**. 3. Open your dot (or create it): it uses the plugins installed and enabled on your account. 4. Ask it for a recurring task with the time, your time zone and when to stop. It lists it in **Scheduled**; its requests for your approval show in its **Activity**. Notes: - Business and Enterprise: an admin allows your own MCP plugins first (**Permissions & roles** → plugins → **Create plugins with MCPs**), and turns dots on (**Admin Console → Permissions → Use dots (Beta)**). - Your rules (**Settings → Personalization → Permissions → Custom rules**): keep **Ask before taking action** for Apogee's launches and changes. - ChatGPT cannot send an API key: it connects with Apogee's sign-in only. Written from: [OpenAI docs: connect your own MCP server](https://developers.openai.com/api/docs/guides/custom-mcp-server), [ChatGPT: dots](https://learn.chatgpt.com/docs/dots), [ChatGPT: dots, tasks and memory](https://learn.chatgpt.com/codex/dots/tasks-and-memory), [ChatGPT: dots, controls](https://learn.chatgpt.com/codex/dots/controls). ## Plans - **On ChatGPT dots's side:** Business Premium and Enterprise (an admin turns dots on); Pro outside the EEA, the UK and Switzerland. Launching through your own MCP server needs Business or Enterprise: on Pro it reads only. - **On Apogee's side:** the Pro, Growth or Scale plan includes the MCP server, with credits every month (10,000 on Pro, 30,000 on Growth, 100,000 on Scale); Starter does not. A 7-day trial for €1 includes a quarter of the plan's credits ([plans](https://www.apogee.ad/en/pricing/), [credits](https://www.apogee.ad/developers/credits/)). - **Your ad accounts** connected in the Apogee app (Meta, TikTok or Snapchat): ChatGPT dots sees exactly what your Apogee account sees. ## Check the connection Ask ChatGPT dots, in your own words: 1. "Which Apogee account are you connected to, and with which scopes?" ChatGPT dots calls [`whoami`](https://www.apogee.ad/developers/mcp/whoami/): the Apogee account this connection acts as, the credential used (an assistant's connection or an API key) and its scopes. 2. "List my Meta ad accounts on Apogee, then my TikTok and Snapchat ones." ChatGPT dots calls [`list_ad_accounts`](https://www.apogee.ad/developers/mcp/list-ad-accounts/), with `platform` set to `tiktok` or `snapchat` for the others. An empty list means no ad account of that platform is connected in the Apogee app. Both are reads: free within the daily free reads, nothing changes. If ChatGPT dots does not find Apogee's tools, check that Apogee is turned on where the last step above says. From a terminal: Without a credential the server answers `401` with a `WWW-Authenticate` header pointing to `https://app.apogee.ad/.well-known/oauth-protected-resource/mcp`: that is where OAuth discovery starts. ```bash curl -i -X POST https://app.apogee.ad/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## What it can do ChatGPT dots gets Apogee's 80 tools, filtered by the scopes of its connection: a tool outside them is not even listed. - **Read** (`read`, 54 tools): Read ad accounts, campaigns, ad sets, ads and their numbers on Meta, TikTok and Snapchat, the comments of your ads and the Bridge's stats; follow imports, launches and transfers (nothing is sent). For example: [`whoami`](https://www.apogee.ad/developers/mcp/whoami/), [`list_ad_accounts`](https://www.apogee.ad/developers/mcp/list-ad-accounts/), [`get_account_overview`](https://www.apogee.ad/developers/mcp/get-account-overview/), [`get_top_performers`](https://www.apogee.ad/developers/mcp/get-top-performers/), [`get_platform_overview`](https://www.apogee.ad/developers/mcp/get-platform-overview/), [`get_launch_questions`](https://www.apogee.ad/developers/mcp/get-launch-questions/). - **Launch** (`launch`, 9 tools): Import and upload creatives, prepare and launch ads, run Bridge transfers, create a campaign. For example: [`import_link`](https://www.apogee.ad/developers/mcp/import-link/), [`prepare_launch`](https://www.apogee.ad/developers/mcp/prepare-launch/), [`launch`](https://www.apogee.ad/developers/mcp/launch/), [`prepare_bridge_transfer`](https://www.apogee.ad/developers/mcp/prepare-bridge-transfer/), [`execute_action`](https://www.apogee.ad/developers/mcp/execute-action/). - **Actions** (`actions`, 18 tools): Pause, activate, change budgets and targeting, duplicate, create ad sets and ads from existing posts. For example: [`pause_ad`](https://www.apogee.ad/developers/mcp/pause-ad/), [`update_budget`](https://www.apogee.ad/developers/mcp/update-budget/), [`execute_action`](https://www.apogee.ad/developers/mcp/execute-action/). By effect: 54 only read; 19 prepare a plan or an action; 4 write in Apogee only and 3 change the ad account, after your yes. Every tool, its parameters and its cost: [all the tools](https://www.apogee.ad/developers/mcp/#tools). ## Prompts to start with Replace the [brackets] with your own names. Each prompt ends with Apogee's safety reminder: "Create everything paused, and show me the full recap before you create anything." or "Show me each change and wait for my yes before you make it." ### Every morning, yesterday on every platform with a CPA alert (personal agent) Yesterday on Meta, TikTok and Snapchat, each platform on its own, in a few lines on your phone, and an alert when a platform's CPA drifts. Read only. ```text Every morning at [time], send me yesterday on Meta ([Meta ad account]), TikTok ([TikTok ad account]) and Snapchat ([Snapchat ad account]), each platform on its own: spend, CPA, ROAS, and the 3 best and 3 worst ads. Alert me when a platform's CPA is more than [threshold]% above its 7-day average, and say which ads moved it. Never add the platforms together. If something should change, propose it: Show me each change and wait for my yes before you make it. ``` What it asks you: Your targets once, when Apogee does not know them yet (it can remember them in your business profile). Note: As a recurring task: Claude Duet, Dots, Grok Bot. It only reads: nothing to approve. ### Every evening, the ads that burn budget paused after your OK (personal agent) Your own rule applied every evening on Meta and TikTok: the agent finds the ads that match it, prepares their pause and asks you. Nothing is paused without your yes. ```text Every evening at [time], find the ads of [ad account] that spent more than [multiple]× my target CPA without a purchase over the last [days] days, on Meta and TikTok. Prepare their pause and send me the list (name, platform, spend, why). Show me each change and wait for my yes before you make it. ``` What it asks you: Your target CPA once, when Apogee does not know it yet. The list of ads to pause, with what will change, and your yes (all of them, or the ones you name). Note: As a recurring task: Claude Duet, Dots, Grok Bot. Nothing is paused before you approve the list. ### Every morning, your new creatives launched (personal agent) A personal agent checks your "to launch" folder every morning, prepares the launch with your naming convention, and asks you before anything is created. You answer from your phone. ```text Every weekday at [time], check my Google Drive folder [folder link]. If there are creatives that are not launched yet, prepare a launch in my [campaign] campaign of [ad account], one ad set per concept, with my naming convention and the settings of the latest ad set launched there. Send me the full recap and wait for my yes before you launch. If there is nothing new, say nothing. Create everything paused, and show me the full recap before you create anything. ``` What it asks you: The first time: the launch interview's open questions, one topic at a time. Afterwards it reuses your answers. Each morning with something new: the whole recap (ads ← files, ad sets, texts, budget, status) and your yes. Note: As a recurring task: a personal agent that runs on its own and asks before acting (Claude Duet, Dots, Grok Bot). In a chat, ask it once. ## Guardrails and limits The server enforces them, whatever ChatGPT dots is told: - **Your yes before anything changes.** A launch is [`prepare_launch`](https://www.apogee.ad/developers/mcp/prepare-launch/), the recap, then [`launch`](https://www.apogee.ad/developers/mcp/launch/); a change is an action tool, then [`execute_action`](https://www.apogee.ad/developers/mcp/execute-action/); a Bridge transfer is [`prepare_bridge_transfer`](https://www.apogee.ad/developers/mcp/prepare-bridge-transfer/), then [`bridge_transfer`](https://www.apogee.ad/developers/mcp/bridge-transfer/). Nothing is created, changed or transferred before your explicit yes to the whole recap. - **Ads are created paused** unless you ask otherwise. - **A prepared plan or action is valid 24 hours** and runs once. - **Daily budget cap:** a daily budget above 500 in the ad account's currency is refused ([`budget_above_cap`](https://www.apogee.ad/developers/errors/#budget_above_cap)). - **25 launches and Bridge transfers** per ad account in 24 hours through the MCP and the API. - **2,000 units** per assistant connection or API key in 24 hours: a read 1, a change 2, Apogee's AI 5, a launch or a transfer 10. - **MCP requests:** 600 on Pro, 1,200 on Growth and Scale per 15 minutes ([rate limits](https://www.apogee.ad/developers/rate-limits/)). - **Credits:** reads are free up to 5,000 on Pro, 10,000 on Growth and Scale a day; a change on an ad platform, an ad created and Apogee's AI cost credits, only when they succeed ([credits](https://www.apogee.ad/developers/credits/)). - **Each platform on its own:** Meta, TikTok and Snapchat keep their own currency and attribution; Apogee never adds them up. ## Errors and fixes A refused tool call comes back to ChatGPT dots as a result with `isError: true` and the reason in words, so it can tell you what to do. The common ones: - [`401`](https://www.apogee.ad/developers/errors/#invalid_api_key): Apogee needs authentication, or every call fails The sign-in was disconnected in Apogee, or its refresh token (valid 60 days) expired: connect again from the authorization step. An access token lasts 1 hour and ChatGPT dots renews it on its own. - ChatGPT dots sees Apogee but says it cannot launch or change anything The connection lacks a [scope](https://www.apogee.ad/developers/authentication/#scopes), so those tools are not listed. Connect again and keep **Launch** and **Actions** ticked on Apogee's page. Your ChatGPT dots plan may also connect read tools only (see [Plans](https://www.apogee.ad/developers/mcp/chatgpt-dots/#plans)). - [`403 upgrade_required`](https://www.apogee.ad/developers/errors/#upgrade_required) The Apogee account is not on a plan with the MCP. It works again as soon as the account is on Pro, Growth or Scale. - The option to add Apogee is missing or greyed out Your organization controls it: an administrator allows it first (see [Plans](https://www.apogee.ad/developers/mcp/chatgpt-dots/#plans) and the notes under the steps). - [`402 credits_exhausted`](https://www.apogee.ad/developers/errors/#credits_exhausted) This month's credits and the credit packs are used: buy a pack ([credits](https://app.apogee.ad/settings/credits)) or wait for the 1st of the month (UTC). Reads go on. - [`429`](https://www.apogee.ad/developers/errors/#rate_limited) `rate_limited`, `quota_exceeded`, `daily_read_cap` A limit of the list above is reached: wait the seconds the answer gives ([rate limits](https://www.apogee.ad/developers/rate-limits/)). - [`412 meta_not_connected`](https://www.apogee.ad/developers/errors/#meta_not_connected), `platform_not_connected` Apogee's own Facebook, TikTok or Snapchat connection expired, not ChatGPT dots's: log in to the Apogee app again, or reconnect the platform there. - [`410 plan_expired`](https://www.apogee.ad/developers/errors/#plan_expired), `409 plan_already_launched` The recap was prepared more than 24 hours earlier, or already ran: ask ChatGPT dots to prepare it again. - [`409 same_error_again`](https://www.apogee.ad/developers/errors/#same_error_again) The last launches on this ad account failed with the same error: fix its cause (the platform's message says what), then tell ChatGPT dots it is fixed. Every code: [errors](https://www.apogee.ad/developers/errors/). ## Disconnect - **In Apogee:** Settings → Personal agents → **Connected agents**, then **Disconnect** next to ChatGPT dots. It loses access at once; ads already launched are not touched, and you can connect it again at any time. - **In ChatGPT dots:** remove Apogee where you added it. ## Guides and related pages - [ChatGPT dots for Meta Ads: your AI media buyer on TikTok and Snap too](https://www.apogee.ad/en/blog/chatgpt-dots-meta-ads/) (English) · [ChatGPT dots et Meta Ads : votre media buyer IA, TikTok et Snap inclus](https://www.apogee.ad/blog/chatgpt-dots-meta-ads/) (Français) · [ChatGPT dots y Meta Ads: su media buyer de IA, TikTok y Snap incluidos](https://www.apogee.ad/es/blog/chatgpt-dots-meta-ads/) (Español) - [Meta Ads MCP: run your ads from Claude, ChatGPT or Cursor](https://www.apogee.ad/en/blog/meta-ads-mcp/): the options for a Meta Ads MCP, compared - Same vendor: [ChatGPT](https://www.apogee.ad/developers/mcp/chatgpt/) - [The MCP server](https://www.apogee.ad/developers/mcp/): how a launch works, every tool, prompt templates - [Authentication](https://www.apogee.ad/developers/authentication/): API keys, OAuth, scopes - [Every assistant, for AI agents](https://www.apogee.ad/developers/llms.txt)