MCP tool · Performance
get_account_spend_limit
The account's spend cap, amount spent and balance.
What it does
Get account spend cap, amount spent, balance, and currency. Use when user asks about account limits or remaining budget.
Parameters
-
ad_account_idstring requiredMeta ad account id (act_…), from list_ad_accounts
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": "get_account_spend_limit",
"arguments": {
"ad_account_id": "act_1234567890"
}
}
} 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":"get_account_spend_limit","arguments":{"ad_account_id":"act_1234567890"}}}' 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). |
| Daily cap | Counts 1 unit toward the 2,000 units one API key or assistant connection can use in 24 hours. |
Related tools
Performance: The same reads as Apogee's Autopilot, with the same numbers as the app. Ad names follow your naming convention: ask per concept or per hook.
get_account_overview: Spend, impressions, clicks, CTR, CPC, ROAS and conversions of the ad account for a period.get_campaigns: The campaigns with their budget, spend and results.get_adsets: The ad sets with their targeting, budget and metrics.get_ads: The ads with their creative and metrics.get_top_performers: The best and the worst campaigns, ad sets or ads by ROAS, CPA, CTR or spend: what to scale, what to cut.get_daily_breakdown: Spend, ROAS, CPA and add to carts day by day.get_ad_performance_by_placement: Results by placement (Feed, Stories, Reels…).get_ad_performance_by_age_gender: Results by age and gender.get_ad_performance_by_device: Results by device.get_creative_fatigue_metrics: Frequency, CTR trend and CPC over time; flags tired creatives.get_video_metrics: Hook rate, hold rate, completion and ThruPlay per video ad.get_ad_creatives: The images, videos and texts of the ads of an ad set or a campaign.get_audience_insights: The targeting and estimated audience size of ad sets.get_campaign_budget_optimization: Whether a campaign uses a campaign budget (CBO), and that budget.