MCP
Meta MCP Server — Official Setup and Configuration Guide for 2026
Meta MCP server official setup and configuration connects your Facebook Business Manager to AI tools like Claude in under 5 minutes. No API tokens, no developer apps, no 3-day review process — just OAuth authentication and instant access to real-time campaign data.
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 the Meta MCP server?
The Meta MCP server is an official Model Context Protocol endpoint hosted by Meta at mcp.metamkt.com that connects AI tools like Claude, ChatGPT, and Cursor directly to your Facebook Business Manager account. Released in public beta on April 29, 2026, it eliminates the need for custom developer apps, API tokens, or 3-day review processes that previously blocked marketers from automating their Meta Ads workflows.
Before this official release, connecting AI to Meta Ads required building a Facebook Developer App, navigating complex API documentation, managing OAuth flows manually, and waiting 3-7 business days for Meta’s App Review team to approve your integration. Third-party MCP providers charged $25-99 monthly for this access. Now, the meta mcp server official setup and configuration takes under 5 minutes with a single OAuth click using your existing Facebook Business login.
The server supports real-time access to campaign performance, ad set metrics, audience insights, creative analysis, and budget data across Facebook and Instagram. Unlike static CSV exports that become stale within hours, the Meta MCP server pulls live data on demand. This enables AI assistants to detect creative fatigue as it happens, flag budget inefficiencies in real-time, and generate reports with current metrics instead of yesterday’s numbers.
The integration works with any MCP-compatible AI client. For the full automation workflow guide, see How to Use Claude for Meta Ads. If you prefer Google Ads automation, check out Claude Skills for Google Ads.
1,000+ Marketers Use Ryze





Automating hundreds of agencies




★★★★★4.9/5
What are the 4 Meta MCP server setup methods?
There are four ways to connect the Meta MCP server to your AI tools, each with different complexity levels, data freshness guarantees, and maintenance requirements. The choice depends on your technical comfort, security needs, and automation frequency.
| Method | Setup Time | Technical Level | Maintenance | Best For |
|---|---|---|---|---|
| Official Meta MCP Direct | Under 5 minutes | Beginner | Zero — Meta handles all | Everyone (recommended) |
| Ryze MCP Connector | 2 minutes | Beginner | Managed service | Agencies + advanced features |
| Self-hosted MCP Router | 15-30 minutes | Intermediate | Updates + monitoring | Data-sensitive enterprises |
| Custom FastAPI Deploy | 2-4 hours | Advanced | Full responsibility | Custom integrations |
Official Meta MCP Direct is the simplest approach. Add mcp.metamkt.com to your AI client’s MCP servers list, authenticate with Facebook Business OAuth, and you’re connected. Free during public beta, zero maintenance, and works with Claude, ChatGPT, Cursor, and Perplexity out of the box.
Ryze MCP Connector offers the official Meta connection plus additional features like multi-account management, automated reporting schedules, and integration with Google Ads. Visit get-ryze.ai/mcp for the managed service approach.
Self-hosted MCP Router uses the open-source mcp-router project to run your own proxy server. You maintain control over authentication flows and data handling while still connecting to Meta’s official endpoint. Requires Docker knowledge and ongoing security updates.
Custom FastAPI Deploy involves building your own MCP server using FastAPI, Flask, or Node.js. You handle OAuth, rate limiting, error handling, and API versioning. Only recommended for enterprises with specific compliance requirements or custom functionality needs.
How do you set up the official Meta MCP server?
The official meta mcp server setup and configuration requires Claude Pro or higher ($20/month), access to Facebook Business Manager, and Admin permissions on at least one ad account. Total setup time is under 5 minutes. Here’s the complete walkthrough for each supported AI client.
Step 01
Verify Facebook Business Manager permissions
Navigate to business.facebook.com and verify you can see ad accounts under Business Settings > Accounts > Ad Accounts. Your role must be Admin — Advertiser or Analyst permissions are insufficient for MCP authentication. If you lack admin access, ask the account owner to upgrade your permissions before proceeding.
Step 02
Add Meta MCP server to your AI client
The configuration varies by AI client. Choose your platform below:
Claude Desktop
- Open Claude Desktop > Settings > Connectors > Add custom connector
- Server URL:
https://mcp.metamkt.com - Name:
Meta Ads - Transport:
HTTP - Click Save
Claude Web (claude.ai)
- Click profile icon > Settings > Integrations > Add integration
- Select MCP Server from the dropdown
- Enter endpoint:
https://mcp.metamkt.com - Enable the integration
ChatGPT (Plus or higher)
- Enable Developer mode in Settings > Beta features
- Go to profile > Settings > Connectors > Add MCP server
- URL:
https://mcp.metamkt.com - Authentication: OAuth 2.0
Config-based clients (Cursor, Codex)
Edit your MCP configuration file (typically ~/.cursor/mcp.json):
Step 03
Complete OAuth authentication
After adding the MCP server, your AI client will prompt for authentication. Click "Authenticate with Meta" to open the Facebook Business OAuth flow. Grant permissions for ads_management, ads_read, business_management, and pages_read_engagement. The process takes 15-30 seconds and uses the same login flow as Facebook Business Manager.
Step 04
Test the connection
Ask your AI client: "Show me my Meta Ads performance for the last 7 days." If the connection works, you’ll see a table with campaign names, spend, impressions, clicks, conversions, and ROAS. If you get an error about is_ads_mcp_enabled: false, see the troubleshooting section below.
Ryze AI — Autonomous Marketing
Skip the setup — 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
What configuration options does Meta MCP server support?
The Meta MCP server supports several configuration parameters to customize data access, rate limiting, and response formatting. These settings are passed as environment variables or URL parameters depending on your setup method.
Authentication Settings
| Parameter | Default | Description |
|---|---|---|
| oauth_scope | ads_management,ads_read | Facebook API permissions requested during OAuth |
| token_refresh_buffer | 300 seconds | Refresh access token this many seconds before expiry |
| retry_count | 3 | API request retries on transient errors |
Data Access Controls
| Parameter | Default | Description |
|---|---|---|
| max_date_range | 90 days | Maximum date range for performance queries |
| result_limit | 1000 rows | Maximum rows returned per API call |
| include_archived | false | Include deleted/archived campaigns in results |
For self-hosted deployments, these parameters can be set via environment variables (e.g., META_MCP_MAX_DATE_RANGE=180) or passed as query parameters in the MCP server URL. The official Meta endpoint uses sensible defaults optimized for performance and compliance with Facebook’s API usage policies.
How do you troubleshoot common Meta MCP server issues?
The most common issue during meta mcp server official setup and configuration is the is_ads_mcp_enabled: false error. This occurs because Meta is rolling out MCP access in phases, starting with Business Manager accounts created before 2024. Here are the top 5 issues and their solutions.
Issue 1: is_ads_mcp_enabled: false
Error: {"error": "MCP access not enabled", "is_ads_mcp_enabled": false}
Cause: Your Facebook Business account is not yet included in the MCP beta rollout. Meta is prioritizing accounts with > $10K monthly ad spend and active Business Manager usage.
Solution: Use a third-party MCP provider like Ryze AI MCP, Pipeboard, or Composio while waiting for Meta to enable your account. These services cost $25-99/month but provide immediate access.
Issue 2: OAuth authentication fails
Error: {"error": "insufficient_permissions", "required": "ads_management"}
Cause: Your Facebook Business Manager role is Advertiser or Analyst instead of Admin. The MCP server requires Admin permissions to access campaign data and make optimization recommendations.
Solution: Ask your Business Manager admin to upgrade your role to Admin in Business Settings > People > [Your Name] > Assign Assets.
Issue 3: Connection timeout
Error: {"error": "request_timeout", "url": "mcp.metamkt.com"}
Cause: Corporate firewalls or VPNs blocking HTTPS connections to mcp.metamkt.com. Some enterprise networks restrict API endpoints by default.
Solution: Whitelist mcp.metamkt.com and *.facebook.com in your firewall rules, or try connecting from a personal network to confirm the issue.
Issue 4: Empty data responses
Response: {"campaigns": [],"total_count": 0}
Cause: The authenticated account has no active campaigns, or you’re connected to a test ad account instead of your production account.
Solution: Verify you’re authenticating with the correct Facebook account. Check Business Settings > Ad Accounts to confirm campaigns exist and are not paused.
Issue 5: Rate limit exceeded
Error: {"error": "rate_limit_exceeded", "retry_after": 300}
Cause: Facebook’s Marketing API has strict rate limits: 200 requests per hour for most endpoints. Large accounts with 50+ campaigns can hit these limits quickly.
Solution: Wait 5 minutes before retrying, or use more specific queries (filter by date ranges, campaign status) to reduce API calls per request.
What are 8 essential Meta Ads workflows using MCP server?
Once your Meta MCP server connection is active, these 8 workflows automate the most time-consuming Meta Ads management tasks. Each workflow includes the exact prompt to copy-paste into your AI client. These prompts work with Claude, ChatGPT, or any MCP-compatible assistant.
Workflow 01
Real-time creative fatigue detection
Identifies ads where CTR declined > 25% over the past 7 days or frequency exceeded 3.5x. Creative fatigue costs advertisers an average 15-20% of their Meta Ads budget when left unchecked for more than 5 days.
Workflow 02
Budget reallocation analysis
Compares ROAS across campaigns and recommends exact dollar shifts to maximize overall performance. Studies show 60% of Meta Ads accounts have at least one campaign receiving 2x the optimal budget allocation.
Workflow 03
Audience overlap audit
Identifies ad sets targeting similar demographics that compete against each other in Meta’s auction. Audience overlap can inflate CPMs by 15-40% when multiple campaigns target the same users.
Workflow 04
Weekly performance report generation
Automatically generates executive-ready reports with key metrics, trend analysis, and specific action items. Saves 2-3 hours of manual report building per week for most advertising teams.
Workflow 05
CPM anomaly detection
Flags unusual CPM spikes that indicate increased competition, targeting issues, or creative problems. Early detection prevents $200-500 daily in wasted spend on large accounts.
Workflow 06
A/B test statistical analysis
Calculates statistical significance for creative, audience, and placement tests. Prevents premature test conclusions that lead to suboptimal scaling decisions.
Workflow 07
Lookalike audience optimization
Analyzes which lookalike percentages and seed audiences generate the best ROAS. Recommends refreshing stale lookalikes that haven’t been updated in 90+ days.
Workflow 08
Placement performance optimization
Identifies underperforming placements (Facebook feed vs Instagram Stories vs Audience Network) and recommends placement exclusions to improve overall campaign efficiency.

Sarah K.
Paid Media Manager
E-commerce Agency
The Meta MCP server setup took 3 minutes. Now I get creative fatigue alerts in real-time instead of discovering them a week later in manual reviews. Our creative refresh cycle went from 14 days to 5 days.”
3 min
Setup time
5 days
Refresh cycle
Real-time
Fatigue alerts
Frequently asked questions
Q: Is the Meta MCP server free to use?
Yes, the official Meta MCP server at mcp.metamkt.com is free during public beta. You need Claude Pro ($20/month) or ChatGPT Plus to connect, but Meta doesn’t charge for API access through the MCP endpoint.
Q: What does is_ads_mcp_enabled: false mean?
This error means your Facebook Business account isn’t yet included in Meta’s MCP beta rollout. Meta is prioritizing accounts with >$10K monthly spend. Use third-party MCP providers like Ryze AI while waiting.
Q: Which AI clients support the Meta MCP server?
Claude Desktop and Web, ChatGPT Plus/Pro, Cursor, Perplexity, and any client supporting MCP over HTTP. Setup instructions vary slightly but all use the same endpoint: https://mcp.metamkt.com.
Q: Do I need a Facebook Developer App?
No. The official Meta MCP server eliminates the need for custom developer apps, API tokens, or App Review submissions. Authentication uses standard Facebook Business OAuth — the same login flow as Business Manager.
Q: Can the MCP server make changes to my ads?
The current beta version is read-only — it pulls data for analysis but cannot modify campaigns, adjust budgets, or pause ads. Write permissions may be added in future releases pending Meta’s security review.
Q: How does this compare to Ryze AI?
Meta MCP + AI assistants require manual prompts and implement recommendations yourself. Ryze AI is fully autonomous — it monitors 24/7, detects issues automatically, and executes optimizations with built-in guardrails.
Ryze AI — Autonomous Marketing
Connect to Meta MCP 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

