Connect Meta Ads to an AI assistant

Connect Meta Ads to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 57 tools behind the answers.

Both readings are on this page.

For you

What the answer looks like, and what to type to get it.

Facebook and Instagram delivery, creatives, audiences, lift studies, catalogue joins.

Connect itLink to this section

Open the dashboard and choose this platform.
Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
Tick the accounts to expose. Nothing is readable until you do.
Paste the endpoint into your assistant, or use the shared one for every platform at once.

textMeta Ads on its own endpoint

https://mcp.getmcpads.com/meta-ads/mcp

What to askLink to this section

text

Spend, CPA and ROAS by campaign for the last 14 days.
Which creatives are losing CTR since launch?
Why is this ad set not delivering?
What audiences exist on this account, and how big are they?
Break performance down by placement, age and platform.
Pause every ad set above 60 EUR CPA.

What answers each oneLink to this section

Question	Tools
Spend, CPA and ROAS by campaign for the last 14 days.	`meta_get_insights`
Which creatives are losing CTR since launch?	`meta_get_insights`, `meta_get_creatives`
Why is this ad set not delivering?	`meta_get_delivery_diagnostics`
What audiences exist on this account, and how big are they?	`meta_get_audiences`
Break performance down by placement, age and platform.	`meta_get_insights`
Pause every ad set above 60 EUR CPA.	`meta_get_insights`, `meta_update_adset_status`

What it can changeLink to this section

Pause or resume a campaign, ad set or single ad. Rename any of the three. Change an ad set or campaign budget, and an ad set schedule. Create a campaign, always paused.

For your agent

The tool sequence, the parameters that matter, and what will be refused.

Both readings as Markdown: /guides/sources/meta-ads.md

Platform id: meta_ads
Tool prefix: meta_
Account parameter: adAccountId
Dedicated endpoint: https://mcp.getmcpads.com/meta-ads/mcp
Tools: 57, 23 of which write
Announced by default: meta_get_campaigns, meta_get_creative_assets, meta_get_delivery_diagnostics, meta_get_insights, meta_health_check, meta_list_ad_accounts, meta_list_ad_images, meta_list_ad_videos
Metrics: 190, see /docs/sources/meta-ads/metrics
Dimensions: 143, see /docs/sources/meta-ads/dimensions

Scope requested from the platformLink to this section

Scope	Grants	Allows writes
`ads_read`	Read Meta campaigns, insights, creatives and audiences.	No
`ads_management`	Create and manage Meta campaigns, ad sets, ads, creatives and audiences, including budgets and status. Writes require a paid plan and explicit confirmation.	Yes
`business_management`	Access Business Manager assets, including owned and shared ad accounts, Pages and catalogs. This permission also permits Business Manager changes.	Yes
`pages_show_list`	List the Facebook Pages you manage and discover linked Instagram professional accounts.	No
`pages_read_engagement`	Read Page posts, media and engagement metadata used by your ads and content reports.	No
`pages_manage_ads`	Create and manage ads associated with your Facebook Pages.	Yes
`read_insights`	Read insights for Facebook Page content you can access.	No
`instagram_basic`	Read your linked Instagram professional account profile and media.	No
`instagram_manage_insights`	Read insights for your Instagram professional account and media.	No
`catalog_management`	Read product catalogs and create or update products and product sets. Writes require a paid plan and explicit confirmation.	Yes

Reaching a tool that is not announcedLink to this section

text

search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks

What will refuse youLink to this section

An account not ticked by the owner. Call list_accounts and use a adAccountId from it.
A write on a plan without writes. The tool is absent from the list and refused if called anyway.
A write without confirm: true returns a preview and applies nothing. That is not an error.
A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

Questions this source answersLink to this section

Question	Tools, in order
Spend, CPA and ROAS by campaign for the last 14 days.	`meta_get_insights`
Which creatives are losing CTR since launch?	`meta_get_insights` then `meta_get_creatives`
Why is this ad set not delivering?	`meta_get_delivery_diagnostics`
What audiences exist on this account, and how big are they?	`meta_get_audiences`
Break performance down by placement, age and platform.	`meta_get_insights`
Pause every ad set above 60 EUR CPA.	`meta_get_insights` then `meta_update_adset_status`