Facebook Ads

What is Facebook Ads MCP Server?

Facebook Ads MCP Server is a project that provides an MCP (Model Context Protocol) server acting as an interface to Facebook Ads. It enables programmatic access to Facebook Ads data and management features, allowing users to interact with their Facebook advertising campaigns and data through an automated system.

How to use Facebook Ads MCP Server?

There are several ways to use the Facebook Ads MCP Server:

Easy One-Click Setup

For a simplified setup, ready-to-use installers are available. You can download the installer from https://gomarble.ai/mcp. This method automatically handles environment setup and prompts for Facebook token authentication.

Manual Setup

1. Prerequisites: Ensure you have Python 3.10+ and the dependencies listed in requirements.txt.
2. (Optional but Recommended) Create and Activate a Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   

3. Install Dependencies:

   pip install -r requirements.txt
   

4. Obtain Facebook Access Token: Secure a Facebook User Access Token with necessary permissions (e.g., ads_read) through the Facebook Developer portal. A guide is available at https://elfsight.com/blog/how-to-get-facebook-access-token/.

Usage with MCP Clients (e.g., Cursor, Claude Desktop)

To integrate with an MCP-compatible client, add a configuration similar to the following, replacing YOUR_FACEBOOK_ACCESS_TOKEN with your actual token and adjusting the path to server.py:

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_ACCESS_TOKEN"
      ]
    }
  }
}

Restart the MCP Client app after making the update.

Debugging the Server

Execute server.py, providing the access token via the --fb-token argument:

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

Installing via Smithery

To install Facebook Ads Server for Claude Desktop automatically via Smithery, use the following command:

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

Key Features of Facebook Ads MCP Server

• Programmatic Access: Enables automated interaction with Facebook Ads data and management features.
• Easy Setup Options: Offers both one-click installers and manual setup instructions.
• Facebook Token Handling: Can automatically create Facebook access tokens via GoMarble's server (without storing them) or allows manual token provision.
• Integration with MCP Clients: Designed to work seamlessly with MCP-compatible clients like Cursor and Claude Desktop.
• Comprehensive Toolset: Provides a wide range of tools for:
  • Account & Object Read: Listing ad accounts, retrieving details for ad accounts, campaigns, ad sets, ads, and ad creatives.
  • Fetching Collections: Retrieving campaigns, ad sets, and ads by ad account or campaign.
  • Insights & Performance Data: Obtaining performance insights for ad accounts, campaigns, ad sets, and ads.
  • Activity/Change History: Retrieving change history for ad accounts and ad sets.
• Pagination Support: Tools support pagination for fetching large datasets.

Use Cases of Facebook Ads MCP Server

• Automated Campaign Management: Programmatically create, update, and manage Facebook ad campaigns, ad sets, and ads.
• Performance Monitoring: Automatically retrieve and analyze performance insights for various levels of Facebook Ads (account, campaign, ad set, ad).
• Data Integration: Integrate Facebook Ads data into other systems or dashboards for comprehensive reporting.
• Custom Reporting: Build custom reports and analytics based on Facebook Ads data.
• Auditing and Tracking: Track changes and activities within Facebook ad accounts and ad sets.
• Development of Custom Tools: Serve as a backend for developing custom applications that interact with Facebook Ads.

FAQ about Facebook Ads MCP Server

• Does this setup require me to manually obtain a Facebook Developer Access Token? No, this setup does not require you to manually obtain a Facebook Developer Access Token. It can connect securely to GoMarble's server to create the token on your behalf.

• Does GoMarble store my Facebook access token? No, GoMarble does not store your token. It is saved locally on your machine for use with the MCP server.

• What happens if my Facebook access token expires? If your Facebook access token expires, you'll need to generate a new one and update the configuration file of the MCP Client with the new token to continue using the tools.

• What are the prerequisites for setting up the server manually? You need Python 3.10+ and the dependencies listed in requirements.txt.

• What kind of data can I retrieve using this server? You can retrieve details about ad accounts, campaigns, ad sets, ads, ad creatives, performance insights, and activity/change history.

Facebook Ads MCP Server

This project provides an MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.

Your browser does not support the video tag.

Easy One-Click Setup

For a simpler setup experience, we offer ready-to-use installers:

👉 Download installer - https://gomarble.ai/mcp

Join our community for help and updates

👉 Slack Community - AI in Ads

Try Google ads mcp server also

👉 Google Ads MCP - Google Ads MCP

What It Does

• Installs and configures the MCP server locally
• Automatically handles environment setup
• Prompts for Facebook token authentication during the process which is optional
• If facebook access token is not provided then connect to GoMarble's server to create the token on your behalf

Important Disclaimer

This setup does not require you to manually obtain a Facebook Developer Access Token.

Instead, it connects securely to GoMarble's server to create the token on your behalf. GoMarble does not store your token — it is saved locally on your machine for use with the MCP server.

---

Setup

Prerequisites

• Python 3.10+
• Dependencies listed in requirements.txt

1. (Optional but Recommended) Create and Activate a Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   

   Using a virtual environment helps manage project dependencies cleanly[Source].

2. Install Dependencies:

   pip install -r requirements.txt
   

3. Obtain Facebook Access Token: Secure a Facebook User Access Token with the necessary permissions (e.g., ads_read). You can generate this through the Facebook Developer portal. Follow this link.

Usage with MCP Clients (e.g., Cursor, Claude Desktop)

To integrate this server with an MCP-compatible client, add a configuration(Claude) similar to the following. Replace YOUR_FACEBOOK_ACCESS_TOKEN with your actual token and adjust the path to server.py if necessary.

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_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_FACEBOOK_ACCESS_TOKEN"
      // ]
    }
  }
}

Restart the MCP Client app after making the update in the configuration.

(Note: On Windows, you might need to adjust the command structure or use cmd /k depending on your setup.)

Debugging the Server

Execute server.py, providing the access token via the --fb-token argument.

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

Available MCP Tools

This MCP server provides tools for interacting with Facebook Ads objects and data:

Tool Name	Description
Account & Object Read
list_ad_accounts	Lists ad accounts linked to the token.
get_details_of_ad_account	Retrieves details for a specific ad account.
get_campaign_by_id	Retrieves details for a specific campaign.
get_adset_by_id	Retrieves details for a specific ad set.
get_ad_by_id	Retrieves details for a specific ad.
get_ad_creative_by_id	Retrieves details for a specific ad creative.
get_adsets_by_ids	Retrieves details for multiple ad sets by their IDs.
Fetching Collections
get_campaigns_by_adaccount	Retrieves campaigns within an ad account.
get_adsets_by_adaccount	Retrieves ad sets within an ad account.
get_ads_by_adaccount	Retrieves ads within an ad account.
get_adsets_by_campaign	Retrieves ad sets within a campaign.
get_ads_by_campaign	Retrieves ads within a campaign.
get_ads_by_adset	Retrieves ads within an ad set.
get_ad_creatives_by_ad_id	Retrieves creatives associated with an ad.
Insights & Performance Data
get_adaccount_insights	Retrieves performance insights for an ad account.
get_campaign_insights	Retrieves performance insights for a campaign.
get_adset_insights	Retrieves performance insights for an ad set.
get_ad_insights	Retrieves performance insights for an ad.
fetch_pagination_url	Fetches data from a pagination URL (e.g., from insights).
Activity/Change History
get_activities_by_adaccount	Retrieves change history for an ad account.
get_activities_by_adset	Retrieves change history for an ad set.

(Note: Most tools support additional parameters like fields, filtering, limit, pagination, date ranges, etc. Refer to the detailed docstrings within server.py for the full list and description of arguments for each tool.)

(Note: If your Facebook access token expires, you'll need to generate a new one and update the configuration file of the MCP Client with new token to continue using the tools.)

Dependencies

• mcp (>=1.6.0)
• requests (>=2.32.3)

License

This project is licensed under the MIT License.

---

Installing via Smithery

To install Facebook Ads Server for Claude Desktop automatically via Smithery:

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