integrations tools apple-search-ads
Apple Search Ads MCP for your AI agent
Cogny's Apple Search Ads integration exposes 21 tools (11 read, 10 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 11readonly reads data.
- 10writecreates or changes something.
- 0destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Apple Search Ads in Cogny. Every Apple Search Ads tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
what each tool does.
Read 11 · only reads data
tool_list_aclsReadList all accessible Apple Search Ads orgs.tool_get_campaignsReadGet campaigns for an org.tool_get_ad_groupsReadGet ad groups for a campaign.tool_get_targeting_keywordsReadGet targeting keywords for an ad group.tool_get_campaign_negative_keywordsReadGet campaign-level negative keywords.tool_get_ad_group_negative_keywordsReadGet ad group-level negative keywords.tool_get_campaign_reportReadGet campaign-level performance report.tool_get_account_spendReadGet total ad spend for the whole org over a date range.tool_get_keyword_reportReadGet keyword-level performance report.tool_get_search_term_reportReadGet search term performance report.tool_search_geo_locationsReadSearch geographic locations for targeting.
Write 10 · creates or changes something
tool_create_campaignWriteCreate a new campaign.tool_update_campaignWriteUpdate campaign fields.tool_update_campaign_statusWriteEnable or pause a campaign.tool_create_ad_groupWriteCreate a new ad group within a campaign.tool_update_ad_groupWriteUpdate an ad group.tool_add_targeting_keywordsWriteAdd targeting keywords to an ad group (up to 1000 per call).tool_add_campaign_negative_keywordsWriteAdd negative keywords at the campaign level.tool_add_ad_group_negative_keywordsWriteAdd negative keywords at the ad group level.tool_delete_targeting_keywordsWriteDelete targeting keywords from an ad group.tool_delete_campaign_negative_keywordsWriteDelete campaign-level negative keywords.
Exact input schemas come from tools/list once Apple Search Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.