MCP
Meta Official MCP — What It Does and How to Install in 2026
Meta official MCP is a free Model Context Protocol server that connects AI tools like Claude and ChatGPT directly to your Meta ad accounts. Released April 2026, it enables real-time campaign management, performance analysis, and automated optimization without third-party tools or API tokens.
Contents
Autonomous Marketing
Grow your business faster with AI agents
- ✓Automates Google, Meta + 5 more platforms
- ✓Handles your SEO end to end
- ✓Upgrades your website to convert better




What is Meta official MCP?
Meta official MCP is a Model Context Protocol server hosted by Meta at mcp.ads.meta.com that enables AI tools like Claude, ChatGPT, and Cursor to connect directly to your Facebook and Instagram ad accounts. Released in public beta on April 29, 2026, it represents the first time Meta has officially opened its advertising infrastructure to third-party AI clients at this integration level.
Unlike third-party MCP services that charged $25-99/month for similar functionality, Meta official MCP is completely free during the beta period. The service eliminates the need for Meta Developer Apps, API tokens, system user setup, or the traditional 3-day app review process that plagued earlier integrations. Authentication happens through a single OAuth click using the same Meta Business login you already use.
The protocol works by exposing 29 core tools at launch that handle everything from campaign creation and audience management to real-time performance reporting and budget optimization. AI clients can read live data, create new campaigns, edit existing structures, pause underperforming ads, and analyze cross-platform performance trends — all through natural language prompts. This marks a significant shift from Meta's historically closed advertising ecosystem to an AI-first automation approach.
For marketers, this means you can prompt Claude with "Create a new conversion campaign targeting US women 25-44 interested in skincare, daily budget $100, pause after creation for review" and the entire campaign structure gets built in seconds. Before Meta official MCP, this same workflow required manual campaign creation, third-party automation tools, or custom API development.
2,000+ Marketers Use Ryze





Automating hundreds of agencies




★★★★★4.9/5
How does Meta MCP work under the hood?
Meta MCP operates as a standardized bridge between AI clients and Meta's Marketing API using the Model Context Protocol specification. When you install Meta MCP in Claude or ChatGPT, the AI client establishes a persistent connection to mcp.ads.meta.com through a secure WebSocket tunnel that maintains your authentication session throughout your workflow.
The authentication flow uses standard OAuth 2.0 with Meta Business accounts. When you first connect, Meta MCP redirects you to the familiar Facebook Business login screen where you grant permissions for campaigns, ad sets, ads, insights, audiences, and catalogs. The resulting access token gets stored server-side by Meta — you never handle tokens directly, and Meta automatically refreshes them before expiration.
Behind the scenes, Meta MCP translates natural language requests into structured Marketing API calls. When you prompt "Show me campaigns with ROAS < 2.0x this week," the MCP server parses your intent, constructs the appropriate GET request with date_preset=this_week and custom ROAS filtering, executes the API call, and formats the response as a readable table. The AI client never touches the Marketing API directly.
| MCP Tool Category | Example Functions | API Endpoints Called |
|---|---|---|
| Campaign Management | Create, edit, pause, delete campaigns | /campaigns, /adsets, /ads |
| Performance Insights | Pull metrics, analyze trends, compare periods | /insights, /delivery_check |
| Audience Tools | Create lookalikes, manage custom audiences | /customaudiences, /saved_audiences |
| Creative Management | Upload images, manage creative library | /adcreatives, /adimages |
Rate limiting happens automatically at the Meta MCP server level, not the client level. Meta enforces standard Marketing API rate limits (200 calls per user per hour, 4800 calls per app per hour), but the MCP server intelligently batches requests and caches frequently accessed data. This means multiple AI queries about the same campaign don't trigger redundant API calls, improving both speed and efficiency.
How to install Meta official MCP (step-by-step guide)
Installing Meta official MCP takes under 5 minutes and works with Claude Pro, ChatGPT Plus (with Developer mode), Cursor, and other MCP-compatible AI clients. This walkthrough covers Claude Desktop as it's the most common use case, with platform-specific notes for other clients.
Step 01
Verify account requirements
You need a Claude Pro subscription ($20/month) or ChatGPT Plus ($20/month) with Developer mode enabled. For Meta, you must have admin or advertiser access to at least one Facebook Business account. Personal Facebook accounts cannot connect to Meta MCP — business access is required.
Check that your Meta Business account shows the "is_ads_mcp_enabled: true" flag. Meta is rolling out MCP access gradually, and some accounts still show "false." You can check this at business.facebook.com > Settings > Data Sources. If your account shows "false," you'll need to wait for Meta's rollout or use a third-party MCP like Ryze MCP Connector as a temporary workaround.
Step 02
Install Claude Desktop (if needed)
Meta MCP requires the Claude Desktop application, not the web version. Download from claude.ai/download and install the native app for your operating system. MCP connections only work through Claude Desktop because the web version doesn't support MCP server protocols.
After installation, sign in with your Claude Pro account. The MCP features only appear for Pro subscribers — Claude Free users cannot connect to external MCP servers.
Step 03
Add Meta MCP server configuration
Open Claude Desktop > Settings > MCP Servers > Add Server. Enter the Meta MCP configuration:
Leave the environment variables empty initially — Meta MCP handles authentication through OAuth, not manual tokens. The package @meta/ads-mcp gets installed automatically when Claude connects.
Click "Save" and restart Claude Desktop. You should see a green checkmark next to "meta-ads" in the MCP Servers list, indicating successful installation.
Step 04
Complete OAuth authentication
Start a new conversation in Claude and type: "Connect to my Meta ads account." Claude will provide a link to mcp.ads.meta.com/auth with a unique session token. Click this link to open the Meta Business authentication flow.
You'll see the familiar Meta Business login screen. Select your business account and grant permissions for:
- Read and manage ad campaigns
- Access insights and performance data
- Manage audiences and catalogs
- Upload and edit ad creatives
After granting permissions, Meta redirects back to Claude with a success confirmation. Claude will display your connected ad accounts and confirm the MCP connection is active.
Step 05
Test the connection
Ask Claude: "Show me my Meta ad performance for the last 7 days." If Meta MCP is working correctly, Claude will return a formatted table with campaign names, spend, impressions, clicks, CTR, conversions, CPA, and ROAS data pulled directly from your ad account.
If Claude asks you to upload a CSV file instead of pulling live data, the MCP connection failed. Common issues include the "is_ads_mcp_enabled: false" flag, incorrect account permissions, or Node.js compatibility problems. See the troubleshooting section below for fixes.
What can you do with Meta official MCP?
Meta official MCP ships with 29 core tools that handle every aspect of Meta advertising workflow. Unlike third-party MCPs that often required workarounds or had limited functionality, the official Meta server provides full read/write access to the Marketing API with the same capabilities as Ads Manager.
Feature 01
Real-time Performance Analysis
Pull live metrics across any date range, compare campaign performance, analyze audience demographics, and identify optimization opportunities. Meta MCP accesses the same insights API that powers Ads Manager, giving you real-time data without CSV exports or manual reporting.
Feature 02
Direct Campaign Creation
The biggest advantage over third-party MCPs: full campaign creation capabilities. Build complete campaign structures including objectives, targeting, budgets, ad sets, and creative associations. Everything gets created in "PAUSED" status by default, letting you review before launch.
Feature 03
Automated Audience Management
Create custom audiences from pixel data, upload customer lists, build lookalike audiences with different similarity percentages, and analyze audience overlap to prevent bid competition. Meta MCP handles the complex audience API calls automatically.
Feature 04
Budget Optimization & Reallocation
Analyze spend efficiency across campaigns, identify budget constraints, detect scaling opportunities, and execute budget changes. Meta MCP can automatically pause underperforming ad sets and increase budgets on winners based on your ROAS targets.
Feature 05
Creative Fatigue Detection
Monitor creative performance trends, detect when CTR starts declining, analyze frequency accumulation, and identify which ads need refresh. Meta MCP tracks creative lifecycle automatically and flags ads approaching fatigue before performance crashes.
Ryze AI — Autonomous Marketing
Skip the prompts — let AI optimize your Meta Ads 24/7
- ✓Automates Google, Meta + 5 more platforms
- ✓Handles your SEO end to end
- ✓Upgrades your website to convert better
2,000+
Marketers
$500M+
Ad spend
23
Countries
Which AI clients support Meta official MCP?
Meta official MCP works with any AI client that implements the Model Context Protocol specification. As of May 2026, five major platforms support MCP connections, each with different setup requirements and feature availability.
| AI Client | Requirements | Setup Complexity | Best For |
|---|---|---|---|
| Claude Desktop | Claude Pro ($20/mo) | Low — GUI setup | Marketers, agencies |
| ChatGPT Desktop | ChatGPT Plus + Developer mode | Medium — config files | Technical users |
| Cursor IDE | Cursor Pro subscription | Medium — extension install | Developers |
| Perplexity Pro | Perplexity Pro ($20/mo) | High — API configuration | Research workflows |
| Open Source Clients | Local setup required | High — command line | Custom integrations |
Claude Desktop provides the smoothest experience with a GUI-based MCP server manager. Add Meta MCP through Settings > MCP Servers, authenticate through OAuth, and start prompting immediately. Most marketers choose Claude because the natural language processing handles complex advertising queries better than ChatGPT's more technical responses.
ChatGPT Desktop requires enabling Developer mode first, then manually editing the MCP configuration file. ChatGPT excels at structured data analysis and provides more consistent table formatting, but requires more technical setup. Best for users who prioritize data analysis over conversational queries.
Cursor IDE integrates Meta MCP as a code extension, making it ideal for developers building Meta advertising tools. You can prompt Cursor to generate ad creation scripts, build custom reporting dashboards, or create automated optimization workflows that run on schedule.
How to troubleshoot Meta MCP connection issues?
The most common Meta MCP issue is the "is_ads_mcp_enabled: false" flag that affects approximately 40% of Meta Business accounts as of May 2026. Meta is rolling out MCP access in phases, prioritizing high-spend accounts and established businesses first. Here are the main issues and their solutions:
Issue 1: "is_ads_mcp_enabled: false" Flag
Symptoms: Meta MCP server installs correctly, but authentication fails with "Account not enabled for MCP access" error. Your business.facebook.com > Settings shows "is_ads_mcp_enabled: false."
Solution: This is a phased rollout limitation, not a permission problem. You have three options: 1) Wait for Meta to enable your account (typically 2-4 weeks), 2) Use a third-party MCP like Ryze MCP Connector temporarily, or 3) Request early access through your Meta account rep if you spend $10K+/month.
Issue 2: Node.js Version Compatibility
Symptoms: MCP server shows red error status in Claude Desktop, or "Failed to start @meta/ads-mcp" error in logs.
Solution: Meta MCP requires Node.js 18.0+ with npm 8.0+. Update Node.js to the latest LTS version, restart Claude Desktop, and reinstall the MCP server. Check your version with "node --version" in terminal.
Issue 3: OAuth Permission Errors
Symptoms: Authentication completes successfully, but Claude cannot access campaign data or gets "insufficient permissions" errors.
Solution: Re-authenticate and ensure you grant all requested permissions: ads_read, ads_management, business_management, and pages_read_engagement. Check that your Meta Business account has Admin or Advertiser role, not just Analyst access.
Issue 4: Rate Limit Errors
Symptoms: Claude returns "API rate limit exceeded" or stops responding after several queries.
Solution: Meta enforces 200 calls per user per hour. Avoid rapid-fire queries and batch multiple requests into single prompts. Meta MCP includes automatic rate limiting, but aggressive usage can still trigger limits. Wait 15-20 minutes before retrying.

Sarah K.
Paid Media Manager
E-commerce Agency
We went from spending 10 hours a week on bid management to maybe 30 minutes reviewing Ryze's recommendations. Our ROAS went from 2.4x to 4.1x in six weeks.”
4.1x
ROAS achieved
6 weeks
Time to result
95%
Less manual work
Frequently asked questions
Q: Is Meta official MCP free to use?
Yes, Meta official MCP is completely free during the public beta period. You only pay for your AI client subscription (Claude Pro $20/mo, ChatGPT Plus $20/mo, etc.). Meta has not announced pricing for post-beta access.
Q: What is the Meta MCP server URL?
The official Meta MCP server is hosted at mcp.ads.meta.com. This is Meta's official endpoint — avoid third-party URLs claiming to be "official" Meta MCP servers.
Q: Can Meta MCP create and edit campaigns?
Yes, Meta official MCP has full read/write access to your ad account. It can create campaigns, edit budgets, pause underperforming ads, upload creatives, and manage audiences. All changes are created in "PAUSED" status by default for review.
Q: Why does my account show "is_ads_mcp_enabled: false"?
Meta is rolling out MCP access gradually. About 40% of accounts still show "false" as of May 2026. This is not a permission issue — it's a phased rollout. You can use third-party MCPs like Ryze while waiting for Meta to enable your account.
Q: Does Meta MCP work with personal Facebook accounts?
No, Meta MCP requires a Facebook Business account with admin or advertiser access. Personal Facebook accounts cannot authenticate with the MCP server, even if they have ad spending history.
Q: How does this compare to third-party MCP services?
Meta official MCP provides the same API access as third-party services but with better reliability, faster updates, and no monthly fees. Third-party MCPs like Ryze offer additional features like Google Ads integration, automated optimization, and managed setup support.
Ryze AI — Autonomous Marketing
Connect Meta MCP to Claude in under 2 minutes
- ✓Automates Google, Meta + 5 more platforms
- ✓Handles your SEO end to end
- ✓Upgrades your website to convert better
2,000+
Marketers
$500M+
Ad spend
23
Countries

