Getting started
What do I need to get started?
A MetaMCP account (free to create), a Meta Business account with at least one ad account, and Claude (any plan including free). Setup takes about 5 minutes: connect your Meta account via OAuth in MCP Settings, generate your connector URL, and paste it into Claude as a custom connector.
Does this work with the free Claude plan?
Yes. MetaMCP works with any Claude plan including the free tier. The connector URL works in both claude.ai (browser) and Claude Desktop.
How do I connect my Meta ad account?
In your MetaMCP dashboard, go to MCP Settings and click "Connect with Facebook". You'll be taken to a Facebook permission dialog — approve access for ads_read, ads_management, and business_management. MetaMCP stores your access token encrypted. Then generate your connector URL and paste it into Claude under Settings → Connectors → Add custom connector.
How do I find my ad account ID?
You don't need to know it — just ask Claude "list my Meta ad accounts" and it will show all accounts you have access to with their IDs, currency, and spend. You can then tell Claude which account to work on by name.
Auditing campaigns
What does a Meta Ads audit cover?
Claude pulls campaign stats, ad set performance, and creative data for your chosen date range. The built-in audit guide checks for: high CPM (possible audience fatigue), low CTR (creative problem), high frequency (audience saturation), low ROAS (unprofitable campaigns), and high cost per lead compared to typical benchmarks. Results are presented as a prioritised table with specific recommendations.
Why is my cost per lead so high?
Ask Claude directly: "Why is my cost per lead up this week?" Claude compares this week's ad set and creative metrics against last week and identifies the likely cause — audience fatigue (frequency too high), creative underperformance (CTR dropped), bid strategy issue, or landing page problem. It tells you which specific ad set or creative is responsible.
Can Claude pause underperforming campaigns?
Yes, but only after you explicitly approve. Claude will present a list of what it proposes to pause — with the metrics that triggered the suggestion — and wait for your "yes" before touching anything. You can also set a threshold: "pause all ad sets with ROAS below 1.5".
Creating campaigns
Will new campaigns go live automatically?
No — never. Every campaign, ad set, and ad MetaMCP creates is set to PAUSED server-side. This is enforced in our code and cannot be overridden by any Claude prompt or tool argument. You must manually enable the campaign in Meta Ads Manager before it can spend anything.
What campaign objectives are supported?
OUTCOME_TRAFFIC, OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, and OUTCOME_SALES. Just describe what you want and Claude picks the right objective — "I want more website visitors" → OUTCOME_TRAFFIC, "I want leads from an instant form" → OUTCOME_LEADS, etc.
How does the budget cap work?
Your daily budget setting in web.config sets a server-side maximum for any new campaign. If Claude tries to create a campaign with a higher budget, it's automatically capped and Claude tells you the budget that was actually applied. This cap cannot be changed through any tool call or prompt — only by you in MCP Settings.
Can Claude generate ad images?
Yes — using the generate_image tool powered by OpenRouter. You need to add an OpenRouter API key in MCP Settings (free keys available at openrouter.ai/keys). Claude generates one image at a time, shows you the result, and waits for your approval before using it in a creative. Supports 1:1 (feed), 9:16 (stories/reels), and 16:9 (landscape) formats.
Multiple accounts & agencies
I manage multiple Meta ad accounts. Does that work?
Yes — one subscription covers all ad accounts connected to your Meta Business Manager. When you connect via OAuth, MetaMCP can see all accounts you have access to. Just ask Claude "list my ad accounts" and then specify which one to work on: "audit the Aminopörssi account for last month".
Can I use MetaMCP for client accounts?
Yes. If your clients have granted your Business Manager access to their ad accounts, Claude can see and manage those too. One of the most useful agency use cases: run a full audit on a prospect's account in a few minutes and produce a client-ready report.
Do I need a separate subscription for each client?
No. One subscription covers all ad accounts you have access to — unlimited accounts, no per-account fee.
Security & data
Is it safe to let an AI manage my Meta ad account?
The safety defaults are built into the server code — they can't be changed by any prompt or leaked URL. Specifically: new campaigns always start PAUSED, budgets are capped server-side, and Claude always presents a full plan and waits for your explicit approval before any write action. Nothing can go live or spend money until you enable it manually in Meta Ads Manager.
What data do you store?
We store your encrypted Meta access token, your Meta user ID (for deauth callbacks), and your connector URL. We do not store campaign data, creative content, audience data, or performance metrics — all of that is fetched live on each request and never persisted.
How do I revoke access?
Two ways: (1) Disconnect in MetaMCP MCP Settings — immediately NULLs your stored token. (2) Remove the app from Facebook Settings → Apps and Websites — triggers our deauth callback which wipes the token. Either works independently. You can also regenerate your connector URL in MCP Settings which invalidates the old one immediately.
How do I cancel my subscription?
Nothing to cancel — subscriptions don't auto-renew. When you subscribe, that month or year is added to your valid-until date. If you don't subscribe again, access simply ends when time runs out. No charge ever happens automatically.
How do I delete my account?
Go to MCP Settings → Danger zone → Delete my account, then type DELETE to confirm. This immediately revokes your connector URL, disconnects Meta, and wipes all stored credentials. It does not affect your Meta ad accounts themselves.
I have a question that's not listed here.
Email us at [email protected] — we typically reply within a day.