Model Context Protocol moderate risk

Facebook Ads

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

Connections & Capabilities

Connects To

GitHubSlackFilesystem

Capabilities

readwrite

Quickstart

Install

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

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"
      // ]
    }
  }
}

Exposed MCP 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.

Safety Assessment

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.

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.

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.