← Back to directory
C

co.pipeboard/meta-ads-mcp

Community
Manage Meta Ads through AI conversation.
GitHub source repository ↗
★ 1.1k Stars Category · Other Very popular
41FMRS · D
Reliability
7/20
Security and permissions
7/20
Maintenance
7/20
Documentation
9/20
Setup experience
11/20

This is a hosted remote MCP server for Meta advertising operations, covering accounts, campaigns, ad sets, ads, creatives, targeting, budgets, and insights. The source documents compatibility with multiple MCP clients and describes write confirmations plus paused initial campaigns; it is not maintained by Meta, and remote use requires evaluating data and advertising-operation risks.

Read the FMRS scoring method →

Meta Ads MCP is a hosted remote MCP server from Pipeboard that lets Claude, ChatGPT, Perplexity, Cursor, and other MCP clients manage Facebook, Instagram, and other Meta ad surfaces through natural language. It covers campaigns, ad sets, ads, creatives, budgets, targeting, and performance analysis. The project uses Meta's public APIs; the hosted service requires no self-hosting or developer token and supports OAuth authentication.

Tools

mcp_meta_ads_get_ad_accounts
Get ad accounts accessible by a user.
mcp_meta_ads_get_account_info
Get detailed information about a specified ad account.
mcp_meta_ads_get_account_pages
Get Facebook Pages associated with an ad account.
mcp_meta_ads_get_campaigns
Get campaigns with optional status filtering.
mcp_meta_ads_get_campaign_details
Get detailed information about a campaign.
mcp_meta_ads_create_campaign
Create a campaign with objectives, budgets, bid strategy, and initial status.
mcp_meta_ads_get_adsets
Get ad sets, optionally filtered by campaign.
mcp_meta_ads_get_adset_details
Get detailed information about an ad set.
mcp_meta_ads_create_adset
Create an ad set with budget, targeting, optimization, billing, and scheduling settings.
mcp_meta_ads_get_ads
Get ads, optionally filtered by campaign or ad set.
mcp_meta_ads_create_ad
Create an ad using an existing creative.
mcp_meta_ads_get_ad_details
Get detailed information about an ad.
mcp_meta_ads_get_ad_creatives
Get creative details including text, images, and URLs.
mcp_meta_ads_create_ad_creative
Create a creative from an uploaded image, supporting simple ads or dynamic creative testing.
mcp_meta_ads_update_ad_creative
Update creative content or settings.
mcp_meta_ads_upload_ad_image
Upload an image for use in an ad creative.
mcp_meta_ads_get_ad_image
Get, download, and visualize an ad image.
mcp_meta_ads_update_ad
Update an ad's status or bid amount.
mcp_meta_ads_update_adset
Update ad set status, targeting, bidding, and frequency controls.
mcp_meta_ads_get_insights
Get performance metrics for an account, campaign, ad set, or ad.
mcp_meta_ads_get_login_link
Get a Meta Ads authentication login link.
mcp_meta_ads_create_budget_schedule
Create a budget schedule for a campaign.
mcp_meta_ads_search_interests
Search interest targeting options by keyword.
mcp_meta_ads_get_interest_suggestions
Get interest suggestions based on existing interests.
mcp_meta_ads_validate_interests
Validate interest names or IDs for targeting.
mcp_meta_ads_search_behaviors
Get behavior targeting options.
mcp_meta_ads_search_demographics
Get demographic and related targeting options.
mcp_meta_ads_search_geo_locations
Search geographic targeting options.
mcp_meta_ads_search
Search accounts, campaigns, ads, and Pages.

Setup

Use the hosted remote MCP: connect a Facebook Ads account through Pipeboard, then add https://meta-ads.mcp.pipeboard.co/ to a compatible MCP client. In Cursor, place the provided configuration in ~/.cursor/mcp.json and complete login. Claude users can add the URL under Integrations; some clients also support appending a Pipeboard token to the URL. Advanced users can deploy locally using the repository's Streamable HTTP guide, but must create their own Meta Developer App.

claude_desktop_config.json
{"mcpServers":{"meta-ads-remote":{"url":"https://meta-ads.mcp.pipeboard.co/"}}}

Fit and risk

Best for

  • Marketers managing Facebook and Instagram advertising
  • Teams wanting conversational AI analysis and control of Meta Ads
  • Users who prefer hosted remote MCP access without managing infrastructure
  • Users needing dynamic creative testing and performance insights

Not for

  • Users who only need read-only reporting and do not want write access
  • Users without Meta advertising activity or an accessible ad account
  • Users requiring fully self-hosted operation with no hosted service
  • Users specifically seeking an MCP server maintained by Meta

Required permissions

  • Requires access to Meta ad accounts, campaigns, ad sets, ads, creatives, Pages, and performance data depending on the tool used
  • Write operations may create or modify campaigns, ad sets, ads, creatives, budgets, statuses, and targeting
  • Authentication uses Pipeboard OAuth or a Pipeboard token; local deployment requires a Meta Developer App

Risks and side effects

  • Creating or updating ads can trigger real delivery and spending; writes should be reviewed before confirmation
  • Incorrect budgets, bids, targeting, or statuses can affect performance and spend
  • The remote service processes ad-account requests; users should evaluate their trust in Pipeboard
  • Image uploads and creative changes can affect brand presentation and campaign results

Troubleshooting

  1. Confirm that the MCP client supports streamable HTTP
  2. Confirm that Pipeboard login is complete and the correct Facebook Ads account is connected
  3. Call mcp_meta_ads_get_ad_accounts first to verify access, then mcp_meta_ads_get_account_info
  4. Check the remote URL and login state in the Cursor configuration
  5. For local deployment, check Streamable HTTP configuration, the Meta Developer App, and token caching
  6. When creating campaigns, use the documented outcome-based objectives rather than deprecated legacy objectives

Use cases

Inspect campaign performance through natural language
Create, pause, and update campaigns, ad sets, and ads
Upload images, create creatives, and test multiple headlines and descriptions
Search interest, behavior, demographic, and geographic targeting
Receive budget, targeting, and creative optimization recommendations

Supported clients

ClaudeFull support
Claude DesktopFull support
ChatGPTFull support
PerplexityFull support
CursorFull support
Cherry StudioFull support