Meta Ads · Claude · ChatGPT

Meta Ads MCP for Claude and ChatGPT, read-only

Spend, impressions, clicks, installs and conversions from your Meta ad accounts, answered in plain words. For ads, V-Kit asks Meta only for ads_read, so it cannot change a campaign.

  • Meta Ads

30 days freethen €19.99/mo or €199/yr · no card

What you can ask

  • “Spend, CTR and cost per install by campaign last week.”
  • “Break down yesterday’s spend by age, gender and placement.”
  • “Compare purchases with 1-day click and 7-day click attribution.”
  • “Which ad sets are active, and what are their objectives, budgets and targeting?”
  • “How many app and pixel events did we get this week?”
  • “Which custom conversions does this ad account have?”

Read-only by design

For ads, Facebook Login asks for ads_read. There is no tool that creates, edits, pauses or deletes campaigns, ad sets, ads or budgets, and the permission would not allow it.

The same Meta connection also covers Facebook Pages and Instagram, each with its own read permissions.

How to connect

  1. Install V-Kit: in Claude, the plugin from claude.ai/customize/plugins; in ChatGPT, the V-Kit plugin from ChatGPT Plugins.
  2. On Connections press Authorize with Meta, keep every permission and pick your businesses and ad accounts.
  3. Ask in a new chat. A good first message: “check v-marketing-kit status”.

Works in Claude Code

Claude Code uses the same V-Kit connector. Run claude plugin marketplace add arey325/marketing-kit-plugin, then claude plugin install v-marketing-kit@v-marketing-kit. After /reload-plugins, open /mcp → v-marketing-kit → authenticate.

Then connect Meta Ads on Connections and ask in Claude Code. The steps are in the Setup guide.

Limits

  • You see the ad accounts where your Facebook account has a role.
  • With the optional business_management permission a client can be linked to one Business portfolio on Connections: that client then sees only the portfolio’s ad accounts, Pages and Instagram accounts. Nothing is changed in Meta.
  • A Meta connection lasts about 60 days; then press Authorize again.
  • Installs here are Meta’s own count; for attribution across channels compare with AppsFlyer.
  • If Facebook says the app isn’t available, Meta’s review of the Marketing Kit app is still pending and only people with a role in the app can connect; write to connect@valas.team.

Questions

Can the AI change my Meta campaigns?

No. V-Kit has no tool for it, and the ads permission it asks for, ads_read, only allows reading.

Are Instagram ads included?

Yes. Instagram ads run through Meta Ads Manager and are in the same reports; break them down by placement. Organic Instagram is the Instagram source.

Does it work in ChatGPT?

Yes. V-Kit is in the ChatGPT plugin directory, on any plan, Free included: open Plugins, find V-Kit, press Install plugin and sign in. The steps are on Install.

Is my data stored?

No. Your Meta Ads numbers are fetched when you ask and passed to your assistant. The server keeps a short in-memory cache (about 15 minutes, per user) so identical requests are not repeated, and a result too large for the chat waits behind a download link for up to 24 hours, for you only. Details are in the privacy policy.

Setup guide for Meta Ads

Read-only access, keys encrypted, your data fetched and not stored. Privacy policy