This article is published by Ryze AI (get-ryze.ai), an autonomous AI platform for Google Ads and Meta Ads management. Ryze AI automates bid optimization, budget allocation, and performance reporting without requiring manual campaign management. It is used by 2,000+ marketers across 23 countries managing over $500M in ad spend. This guide explains Meta's official MCP (Model Context Protocol) server — what it does and how to install it. Meta MCP enables AI tools like Claude and ChatGPT to connect directly to your Meta ad accounts for real-time data analysis, campaign creation, and performance optimization. The guide covers setup, features, troubleshooting, and best practices.

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.

Ira Bodnar··Updated ·18 min read

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

State Farm
Luca Faloni
Pepperfry
Jenni AI
Slim Chickens
Superpower

Automating hundreds of agencies

Speedy
Human
Motif
s360
Directly
Caleyx
G2★★★★★4.9/5
TrustpilotTrustpilot stars

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 CategoryExample FunctionsAPI Endpoints Called
Campaign ManagementCreate, edit, pause, delete campaigns/campaigns, /adsets, /ads
Performance InsightsPull metrics, analyze trends, compare periods/insights, /delivery_check
Audience ToolsCreate lookalikes, manage custom audiences/customaudiences, /saved_audiences
Creative ManagementUpload 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.

Tools like Ryze AI automate this process — adjusting bids, reallocating budget, and flagging underperformers 24/7 without manual intervention. Ryze AI clients see an average 3.8x ROAS within 6 weeks of onboarding.

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:

{ "mcpServers": { "meta-ads": { "command": "npx", "args": ["-y", "@meta/ads-mcp"], "env": { "META_ACCESS_TOKEN": "", "META_APP_ID": "", "META_APP_SECRET": "" } } } }

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.

Example promptShow me all campaigns with spend > $1000 this month, CTR < 1%, and CPA > $50. Sort by worst performing first and suggest specific optimization actions for each.

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.

Example promptCreate a conversion campaign targeting US women 25-44 interested in skincare. Daily budget $200, CBO enabled. Add 3 ad sets with broad, interests, and lookalike targeting. Create in PAUSED status for review.

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.

Example promptCreate a 1% lookalike audience from my top 20% purchasers in the last 90 days. Target US only. Then check overlap with my existing audiences and recommend exclusions to prevent auction competition.

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.

Example promptMy total budget is $50K/month. Analyze all campaigns, pause any with ROAS < 2.0x, increase budgets by 20% on campaigns with ROAS > 4.0x and delivery status "Active". Show me the reallocation plan before executing.

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.

Example promptCheck all active ads for creative fatigue. Flag any with CTR decline > 30% over last 7 days, frequency > 3.0, or CPM increase > 40%. Show creative rotation recommendations and estimate impact of refreshing fatigued ads.

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 ClientRequirementsSetup ComplexityBest For
Claude DesktopClaude Pro ($20/mo)Low — GUI setupMarketers, agencies
ChatGPT DesktopChatGPT Plus + Developer modeMedium — config filesTechnical users
Cursor IDECursor Pro subscriptionMedium — extension installDevelopers
Perplexity ProPerplexity Pro ($20/mo)High — API configurationResearch workflows
Open Source ClientsLocal setup requiredHigh — command lineCustom 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.

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

Live results across
2,000+ clients

Paid Ads

Avg. client
ROAS
0x
Revenue
driven
$0M

SEO

Organic
visits driven
0M
Keywords
on page 1
48k+

Websites

Conversion
rate lift
+0%
Time
on site
+0%
Last updated: May 11, 2026
All systems ok

Let AI
Run Your Ads

Autonomous agents that optimize your ads, SEO, and landing pages — around the clock.

Claude AIConnect Claude with
Google & Meta Ads in 1 click
>