VERIFIED

Facebook Ads

Safety: 65/100

0.0(0)

This MCP server provides an interface to Meta Ads, enabling programmatic access to data and management features, secured by a Meta access token.

MCP ServersData & DatabasesAI & LLMSocial MediaDevelopmentSearch & WebCommunicationUtilitiesFreemium

Boost this tool

Subscribe to listing upgrades or segmented pushes.

Overview

This MCP server provides an interface to Meta Ads, enabling programmatic access to data and management features, secured by a Meta access token.

This MCP server is relatively safe for read-only operations. However, the ability to modify ad campaigns introduces a moderate risk. Securely manage the Meta access token and monitor changes to ad campaigns to mitigate potential risks.

Performance depends on the Meta Ads API's response times and the volume of data being retrieved. Consider implementing caching to improve performance for frequently accessed data.

Cost is primarily associated with Meta Ads API usage, which may have rate limits and usage fees. Monitor API usage to avoid unexpected costs.

CloudPython228 starsMIT

Connections & Capabilities

Connects To

GitHubSlackFilesystem

Capabilities

ReadWrite

Client Compatibility

Claude Desktop

full

Cursor

full

Windsurf

untested

VS Code (Copilot)

untested

Quickstart

Install

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude

Claude Desktop Config

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
      // If using a virtual environment, you might need to specify the python executable within the venv:
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_META_ACCESS_TOKEN"
      // ]
    }
  }
}

Tools (21)

safe

list_ad_accounts

Lists ad accounts linked to the provided Meta access token.

Read-only operation, no modification of data.

safe

get_details_of_ad_account

Retrieves detailed information for a specified ad account.

Read-only operation, no modification of data.

safe

get_campaign_by_id

Retrieves details for a specific ad campaign by its ID.

Read-only operation, no modification of data.

safe

get_adset_by_id

Retrieves details for a specific ad set by its ID.

Read-only operation, no modification of data.

safe

get_ad_by_id

Retrieves details for a specific ad by its ID.

Read-only operation, no modification of data.

safe

get_ad_creative_by_id

Retrieves details for a specific ad creative by its ID.

Read-only operation, no modification of data.

safe

get_adsets_by_ids

Retrieves details for multiple ad sets based on their IDs.

Read-only operation, no modification of data.

safe

get_campaigns_by_adaccount

Retrieves all campaigns associated with a given ad account.

Read-only operation, no modification of data.

safe

get_adsets_by_adaccount

Retrieves all ad sets associated with a given ad account.

Read-only operation, no modification of data.

safe

get_ads_by_adaccount

Retrieves all ads associated with a given ad account.

Read-only operation, no modification of data.

safe

get_adsets_by_campaign

Retrieves all ad sets associated with a given campaign.

Read-only operation, no modification of data.

safe

get_ads_by_campaign

Retrieves all ads associated with a given campaign.

Read-only operation, no modification of data.

safe

get_ads_by_adset

Retrieves all ads associated with a given ad set.

Read-only operation, no modification of data.

safe

get_ad_creatives_by_ad_id

Retrieves all ad creatives associated with a given ad.

Read-only operation, no modification of data.

safe

get_adaccount_insights

Retrieves performance insights for a specified ad account.

Read-only operation, no modification of data.

safe

get_campaign_insights

Retrieves performance insights for a specified campaign.

Read-only operation, no modification of data.

safe

get_adset_insights

Retrieves performance insights for a specified ad set.

Read-only operation, no modification of data.

safe

get_ad_insights

Retrieves performance insights for a specified ad.

Read-only operation, no modification of data.

safe

fetch_pagination_url

Fetches data from a given pagination URL.

Read-only operation, retrieves data from a specified URL.

safe

get_activities_by_adaccount

Retrieves the change history for a specified ad account.

Read-only operation, no modification of data.

safe

get_activities_by_adset

Retrieves the change history for a specified ad set.

Read-only operation, no modification of data.

Security

Auth Method

Token

Data Locality

cloud

Scopes

ads_read

Known Risks

!Compromised Meta access token leading to unauthorized access to ad data and modification of campaigns.
!Potential for unintended financial impact due to misconfigured ad campaign modifications.
!Vulnerabilities in external dependencies (mcp, requests) could be exploited.
!Exposure of Meta access token if not securely managed in client configurations.
!Rate limiting by the Meta Ads API could impact performance and reliability.

Safety Score

moderate risk

Positive

+Requires a Meta access token for authentication, limiting unauthorized access.
+Primarily focuses on reading and retrieving data from Meta Ads.
+Does not inherently execute arbitrary code or system commands.
+GoMarble does not store the token, it is saved locally on your machine.

Risks

-Meta access token could be compromised, leading to unauthorized data access.
-Some tools allow for modification of ad campaigns, which could have financial implications.
-The server relies on external dependencies, which could introduce vulnerabilities.
-Improper handling of the access token in the client configuration could expose it.

Use Cases

Ad Performance Analysis

-Analyzing campaign performance metrics to identify trends.
-Comparing ad set performance to optimize budget allocation.
-Identifying high-performing ads for replication across campaigns.

Campaign Management

-Automating the retrieval of campaign details for reporting.
-Monitoring ad spend and adjusting budgets based on performance.
-Tracking changes to ad sets and campaigns for auditing purposes.

Creative Optimization

-Analyzing the performance of different ad creatives.
-Identifying winning creative elements for future campaigns.
-Retrieving ad creative details for competitor analysis.

Reporting and Automation

-Generating automated reports on key ad metrics.
-Integrating ad data with other marketing platforms.
-Automating ad creation and modification tasks.

Who Is This For?

Best For

Marketing analysts
Ad operations teams
Data scientists
Automation engineers
Reporting specialists

Not Ideal For

Real-time ad bidding systems
High-frequency ad modification scenarios
Environments with strict security requirements and no access to Meta Ads API

Autonomy & Execution

Default ModeRead-only

The server primarily supports read operations. Write operations are limited to modifying ad campaigns. Ensure proper authorization and monitoring when enabling write access.

StatelessYes

Retry LogicNot documented

ConcurrencySingle-threaded

Production Tip

Implement robust error handling and logging to monitor the server's performance and identify potential issues.

FAQ

What permissions are required for the Meta access token?

The Meta access token requires the `ads_read` permission for read-only access. Additional permissions may be required for write operations.

How do I handle expired Meta access tokens?

You need to generate a new Meta access token and update the configuration file of the MCP Client with the new token.

Does this server support modifying ad campaigns?

Yes, some tools allow for modifying ad campaigns, but exercise caution and monitor changes closely.

How can I improve the performance of the server?

Consider implementing caching to improve performance for frequently accessed data and optimize API requests.

What happens if I exceed the Meta Ads API rate limits?

The server will return an error. Implement retry logic with exponential backoff to handle rate limiting.

Is it safe to store the Meta access token locally?

While the token is stored locally, ensure your machine is secure and consider using environment variables or a secure configuration management system.

Can I use this server to automate ad creation?

While the server provides tools for retrieving ad data, ad creation capabilities may be limited. Check the documentation for specific tools.

Key Features

Data & Databases AI & LLM Social Media Development Search & Web Communication Utilities

Metrics

Discovered2/14/2026

Reviews0

Saved By0 users

Related Tools

Facebook Ads | AI Builder Hub Review & Alternatives | Flaex AI