MCP tool · Launch
launch_status
Follows a launch until it is finished. interrupted means an Apogee deploy cut it: check Ads Manager before launching again.
What it does
Follow a launch by its plan_id. status interrupted = a deploy of Apogee cut the launch: some ads may exist, check Ads Manager before launching again.
Parameters
-
plan_idstring required
Example
Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "launch_status",
"arguments": {
"plan_id": "7b0f3c52-4d1e-4c8a-9f61-2a5e8d3c1b90"
}
}
}The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):
curl -X POST https://app.apogee.ad/mcp \
-H "Authorization: Bearer $APOGEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"launch_status","arguments":{"plan_id":"7b0f3c52-4d1e-4c8a-9f61-2a5e8d3c1b90"}}}'Access and cost
| Plans | Pro and Scale. |
|---|---|
| Scope | read: a connection or an API key without it does not see this tool (scopes). |
| Effect | Reads only: nothing is changed, in Apogee or on the ad account. |
| Credits | Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A call that fails costs nothing (credits). |
| Rate limit | 600 MCP requests per 15 minutes on Pro, 1,200 on Scale (rate limits). |
In the REST API
The same thing for your own code, with an API key:
- Get launch plan status:
GET /launch-plans/{id}/status
Related tools
Launch: The interview, the recap, your yes, then the launch.
get_launch_questions: The questions the app asks before every launch, in order, with the choices read from your account and a recommended answer (TikTok's and Snapchat's own withplatform). Called again with the files (it reads their names with your naming convention and proposes the ads) and with the answers so far.prepare_launch: Prepares the launch without creating anything: the whole recap and aplan_id, valid 24 hours. Refuses while a question is open. Starts from scratch, a copied ad set and ad, or saved templates; the ads are new files (grouped by your naming convention or by hand), or existing ads reused with their post ID.launch: Launches a prepared plan (Meta, TikTok or Snapchat: the plan knows), once, after your explicit yes to its recap.create_campaign: Prepares a new campaign, always created paused: name, objective, budget per ad set (ABO) or per campaign (CBO, with its bid strategy).execute_actioncreates it after your OK.