Skip to main content
Læs siden på dansk The Meta Ads connector gives your AI access to your ads on Facebook and Instagram (Marketing API): campaign, ad set and ad performance, conversions, reach, video engagement, audiences, pixels and Lead Ads. It can also create and manage campaigns for you behind clear guardrails. You approve the Consile app via Facebook login, and your AI never sees the access token itself.
Read + guardrailed write. The read tools change nothing. The three create tools make new objects paused (PAUSED) by default; creating as ACTIVE, changing budget, activating or archiving requires your explicit confirmation (confirm: true). See Actions & guardrails.

Access

Read + guardrailed write

Authentication

Meta login (OAuth)

Hosting

Hosted in the EU · Frankfurt
  • Price: 299 DKK/month excl. VAT. No lock-in, cancel at any time. The price covers 1 user and 1 connected Meta login (agreement). Each extra user and each extra agreement costs 149.50 DKK/month excl. VAT. Also included in the Consile Studio membership and the free edition. See Pricing.
  • Users: whoever buys Meta Ads automatically gets the included access. If more colleagues need Meta Ads in their AI, an administrator gives them access under Team in the portal (choose All tools or Custom next to Meta Ads on the person’s page). An extra user is billed pro rata from the day access is given. A colleague without access can still see the tools in their AI, but every call is refused with a message to ask an administrator for access. One access covers all your Meta Ads agreements. If you have the Consile Studio membership, an administrator instead gives one membership licence per person, and it also covers Meta Ads. See Team.
  • Multiple Meta logins and ad accounts: the portal calls each connection to the system an agreement. One agreement gives access to the ad accounts and Pages that the connected Meta user has access to, and that you gave access to in Meta’s dialog. You need one more agreement if you want to connect another Meta user, or if each ad account should have its own connection, locked to exactly that account (see the section on locking below). An administrator clicks Add agreement on the Connections card on the Meta Ads page in the portal. Each agreement gets its own address, for example https://mcp.consile.ai/meta-ads-2/mcp, which you add in your AI as a separate connector. If you connect the same Meta user on two agreements without locking them, it does not give access to more. Under the Consile Studio membership there is no button to add an agreement, so write to support@consile.dk instead. See Connect Meta Ads.
  • Endpoint: https://mcp.consile.ai/meta-ads/mcp (your own named connector in Claude).

​
Prerequisites

1

Connector bought

An administrator buys Meta Ads in the portal: open Marketplace, choose Meta Ads and click Add connector. See Buy a connector.
2

Your AI connected

See Connect Claude or Connect ChatGPT.
3

Meta connected

Click Connect now on the Meta Ads page in the portal, log in with Facebook and approve all the permissions the Consile app asks for. Expect to connect Meta Ads again about every 60 days. See Connect Meta Ads.

​
What can it do? (tools)

You do not need to know the tool names. You ask in natural language, and your AI picks and calls the right tool itself. The tools are called meta-ads__<tool> (for example meta-ads__account_insights) when your AI calls them; below, the bare names are shown for readability. The connector provides 39 tools in total: 34 read-only (pure reading) and 5 guardrailed write tools. Typically your AI starts with list_ad_accounts to find the act_<id> that the rest of the tools use.

​
Reading (34 read-only)

Accounts & structure Creatives & assets Performance & insights Tracking & configuration Audiences & planning Audit & change log Leads (Lead Ads)
list_leads and get_lead return personal data (name, email, phone from field_data). Leads are fetched directly from Meta when your AI asks for them, and are not stored at Consile. See GDPR & your rights.
Advanced

​
Writing (5 guardrailed tools)

These five tools are the only ones that change anything in your Meta account. New objects are created PAUSED by default. Anything that makes something live (ACTIVE), changes a budget or archives (ARCHIVED) requires confirm: true. Without confirmation you only get a preview, and nothing is sent to Meta. On a connection that is locked to one ad account, update_status and update_budget are hidden. See the section on locking below.

Building on top yourself? See the API reference

Full reference with arguments, pagination, filters, guardrail fields and return values for each tool.

​
How the guardrail works

The safety is built into the connector itself:
  1. Everything new is created paused. A new campaign, ad set or ad is PAUSED by default and spends no money until you ask for it.
  2. Going live, budget changes and archiving require confirm: true. Making something live (ACTIVE), changing a budget or archiving requires your AI to send an explicit confirmation. Without it, you get a structured preview of exactly what would happen, and no call is sent to Meta. A bid can only be set when an ad set is created (bidAmountMinor); there is no tool for changing a bid afterwards.
  3. No deleting. Removal only happens by archiving (status ARCHIVED), and it requires confirmation.
The write tools are marked as modifying to your AI client, so clients like Claude can ask for your permission before they run.
How preview and confirmation work across all write connectors is described under Actions & guardrails.

​
Try asking

“Show the account’s performance for the last 30 days: spend, clicks, CTR and CPC.”
“Which campaigns had the best cost per lead last month?”
“Break the last 14 days down by gender and age.”
“What do my best-performing ads say, and what do they link to?”
“Which image and headline variant drives the most results in the dynamic ad?”
“How many watch the video all the way to ThruPlay?”
“How large an audience can I reach in Denmark among 18-35-year-olds interested in running?”
“Which custom audiences exist on the account, and roughly how large are they?”
“How many leads has my latest Lead Ads form captured?”
“Show the newest leads with name and email.”
“Create a campaign ‘Spring 2026’ with the objective OUTCOME_LEADS, and leave it paused.”
“Raise the budget on ad set 1234 to 200 DKK a day.” (you are asked to confirm)
“Activate campaign 5678.” (you get a preview and must confirm before it starts spending)
Mention a date range (or for example “last 7 days”) and an ad account in the question, so you get a precise answer right away. Budgets are given in the currency’s smallest unit, for example øre (20000 = 200.00 DKK).

​
Lock to one company

A Meta login can reach several ad accounts. An administrator can lock an agreement to one ad account, so every call on that agreement keeps to it. The lock is optional. Without a lock, the connection works as before, and all 39 tools are there. On a locked connection:
  • list_ad_accounts only shows the locked ad account.
  • The tools still need the ad account (adAccountId), and it must be the locked one. If your AI names another account, the call is refused, and your AI is told which account the connection is locked to.
  • list_ad_sets, list_ads, campaign_insights, ad_set_insights and ad_insights cannot be limited to one campaign, one ad set or one ad. They answer for the whole ad account with one row per campaign, ad set or ad.
  • create_campaign, create_ad_set and create_ad work as before and always create in the locked ad account.
  • 11 tools cannot be limited to one ad account. They are hidden, so your AI does not see them and cannot call them. 28 tools are left.
If an administrator connects the agreement again with Reconnect or a link from your AI, all calls are refused until an administrator has chosen the ad account again. If an administrator disconnects, the lock disappears. An ad account can only be locked on one agreement at a time. How to lock, and what else happens: Lock a connection to one company.

​
Limitations

  • Writing is guardrailed, not unrestricted. The five write tools can create and manage campaigns, but only behind the confirmation barrier above. See Actions & guardrails.
  • No fixed access levels. Meta Ads does not have the Read only level. A user with All tools under Team gets all the tools the organization has switched on, including the five write tools. If a user should only have some of them, for example only the read tools, an administrator chooses Custom. See Custom access.
  • No deleting. Objects can only be archived, not deleted permanently.
  • Bids can only be set on creation. A bid cap (bidAmountMinor) can be given when an ad set is created, but the connector cannot change bids afterwards. You do that in Ads Manager.
  • Creatives are not built from scratch. Ads are created from an existing creative (from list_creatives); uploading images/video is not supported in this version.
  • Audiences are metadata only. Custom Audiences never return members. Meta only stores hashes.
  • Errors from Meta are not shown verbatim. If Meta refuses a call, for example an invalid audience spec, your AI only gets the message Tool invocation failed. without Meta’s explanation. If only one write call fails, check the values (objective, optimization, budget, audience) in Ads Manager. If all calls fail, connect Meta Ads again.
  • Reconnect about every 60 days. Access to Meta usually expires after about 60 days. If it has expired, your AI gets a message that Meta Ads must be connected again. If you have revoked access at Meta, you also have to reconnect. The Connected status in the portal shows that access is stored, not that it still works. Only an administrator can reconnect. If the agreement is locked, the ad account must be chosen again afterwards. How to reconnect: see Connect Meta Ads.
Is something not working as expected? See Troubleshooting.