gomarble-ai avatar

Facebook Ads

gomarble-ai/facebook-ads-mcp-server

Connects to the Meta Ads API to pull campaigns, ad sets, ads, and performance insights directly into your MCP client. You get read access to account hierarchies, change history, and metrics across different date ranges and breakdowns. Useful when you're analyzing campaign performance, auditing account structure, or building reports without jumping into Ads Manager. The server handles pagination and supports filtering on most endpoints. Requires a Meta User Access Token with ads_read permissions, which you can generate through the Meta Developer portal or their authentication flow. Ships with a one-click installer that manages token setup locally, or you can run it manually via Python with your own token.

GitHub stars
324
tools
21
last updated
Jan 27, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

list_ad_accountsLists ad accounts linked to the token.

Lists ad accounts linked to the token.

No parameter schema in public metadata yet.

get_details_of_ad_accountRetrieves details for a specific ad account.

Retrieves details for a specific ad account.

No parameter schema in public metadata yet.

get_campaign_by_idRetrieves details for a specific campaign.

Retrieves details for a specific campaign.

No parameter schema in public metadata yet.

get_adset_by_idRetrieves details for a specific ad set.

Retrieves details for a specific ad set.

No parameter schema in public metadata yet.

get_ad_by_idRetrieves details for a specific ad.

Retrieves details for a specific ad.

No parameter schema in public metadata yet.

get_ad_creative_by_idRetrieves details for a specific ad creative.

Retrieves details for a specific ad creative.

No parameter schema in public metadata yet.

get_adsets_by_idsRetrieves details for multiple ad sets by their IDs.

Retrieves details for multiple ad sets by their IDs.

No parameter schema in public metadata yet.

get_campaigns_by_adaccountRetrieves campaigns within an ad account.

Retrieves campaigns within an ad account.

No parameter schema in public metadata yet.

get_adsets_by_adaccountRetrieves ad sets within an ad account.

Retrieves ad sets within an ad account.

No parameter schema in public metadata yet.

get_ads_by_adaccountRetrieves ads within an ad account.

Retrieves ads within an ad account.

No parameter schema in public metadata yet.

get_adsets_by_campaignRetrieves ad sets within a campaign.

Retrieves ad sets within a campaign.

No parameter schema in public metadata yet.

get_ads_by_campaignRetrieves ads within a campaign.

Retrieves ads within a campaign.

No parameter schema in public metadata yet.

get_ads_by_adsetRetrieves ads within an ad set.

Retrieves ads within an ad set.

No parameter schema in public metadata yet.

get_ad_creatives_by_ad_idRetrieves creatives associated with an ad.

Retrieves creatives associated with an ad.

No parameter schema in public metadata yet.

get_adaccount_insightsRetrieves performance insights for an ad account.

Retrieves performance insights for an ad account.

No parameter schema in public metadata yet.

get_campaign_insightsRetrieves performance insights for a campaign.

Retrieves performance insights for a campaign.

No parameter schema in public metadata yet.

get_adset_insightsRetrieves performance insights for an ad set.

Retrieves performance insights for an ad set.

No parameter schema in public metadata yet.

get_ad_insightsRetrieves performance insights for an ad.

Retrieves performance insights for an ad.

No parameter schema in public metadata yet.

fetch_pagination_urlFetches data from a pagination URL (e.g., from insights).

Fetches data from a pagination URL (e.g., from insights).

No parameter schema in public metadata yet.

get_activities_by_adaccountRetrieves change history for an ad account.

Retrieves change history for an ad account.

No parameter schema in public metadata yet.

get_activities_by_adsetRetrieves change history for an ad set.

Retrieves change history for an ad set.

No parameter schema in public metadata yet.

Sponsors

Readme

Details

Repository
github.com/gomarble-ai/facebook-ads-mcp-server
Categories
Data & Analytics, Finance & Commerce

Related Data & Analytics MCP servers

View all
1joshuarileydev avatarApp Store Connectjoshuarileydev/app-store-connect-mcp-serverProvides direct MCP access to App Store Connect data and actions through authenticated commands and tools.322stars
2explorium-ai avatarVibe Prospectingexplorium-ai/vibeprospecting-mcpB2B company and contact data for lead lists, enrichment, research, and outreach. OAuth sign-in.294stars
3harimxchoi avatarGoogle Surf Mcpharimxchoi/google-surf-mcpWeb, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.291stars
4ivnvxd avatarOdooivnvxd/mcp-server-odooA Model Context Protocol (MCP) server that enables AI assistants to securely interact with Odoo ERP systems through standardized resources and tools for data re282stars
5zwldarren avatarAkshare One Mcpzwldarren/akshare-one-mcpMCP server that provides access to Chinese stock market data using akshare-one242stars
6cnych avatarSEOcnych/seo-mcpProvides SEO data access via MCP: backlinks, keywords, traffic, and difficulty with CapSolver-backed CAPTCHA solving.241stars