Facebook Ads MCP Server

What does “Facebook Ads” MCP Server do?

The Facebook Ads MCP Server is a Model Context Protocol (MCP) server that acts as an interface to the Facebook Ads platform, allowing AI assistants and development environments to programmatically access and manage Facebook Ads data. By connecting this MCP server to your AI client, you can automate tasks such as querying ad performance, managing campaigns, and accessing reports, all without the need to manually interact with the Facebook Ads UI. The server streamlines authentication—either prompting for your access token or generating one for you via GoMarble’s secure infrastructure—making the setup simple. This integration empowers developers to build, manage, and analyze ad campaigns more efficiently by leveraging AI-driven workflows and automations.

List of Prompts

No information found in the repository regarding available prompt templates.

List of Resources

No explicit resource definitions found in the repository or documentation.

List of Tools

No explicit tool list found in the documentation or in the visible server.py description. The section “Available MCP Tools” is present in the readme, but no further details are provided within the retrieved content.

Use Cases of this MCP Server

• Facebook Ads Campaign Management
  Automate the creation, updating, and deletion of Facebook ad campaigns through AI workflows, reducing manual effort and minimizing errors.
• Performance Reporting
  Retrieve ad performance metrics and analytics directly into your AI-driven dashboard or workflow for real-time insights and optimization.
• Bulk Ad Operations
  Execute batch operations such as pausing, activating, or editing multiple ads simultaneously, enhancing operational efficiency.
• Seamless Integration with AI Agents
  Enable AI assistants to answer questions, generate reports, or suggest optimizations based on live Facebook Ads data.
• Access Control and Security
  Centralize and secure token management, minimizing direct exposure of credentials and streamlining setup for teams.

How to set it up

Windsurf

1. Ensure Python 3.10+ is installed and dependencies in requirements.txt are satisfied.

2. Obtain a Facebook Access Token with the necessary permissions.

3. Locate your Windsurf configuration file.

4. Add the Facebook Ads MCP Server to the mcpServers section:

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

5. Save the config and restart Windsurf. Verify the MCP server appears in the interface.

Securing API Keys

Use environment variables to secure your access token:

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

Claude

1. Install Python 3.10+ and dependencies from requirements.txt.

2. Obtain a Facebook Access Token.

3. Edit the Claude configuration as follows:

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

4. Save and restart Claude. Verify the server connection.

Cursor

1. Install Python 3.10+ and dependencies.

2. Acquire a Facebook Access Token.

3. Update the Cursor MCP configuration:

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

4. Restart Cursor after saving changes.

Cline

1. Ensure Python 3.10+ and dependencies are installed.

2. Secure your Facebook Access Token.

3. Edit the Cline configuration file:

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

4. Save and restart Cline.

Securing API Keys

Always use environment variables for sensitive credentials (see JSON examples above).

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "facebook-ads-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “facebook-ads-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Between the sections above, the Facebook Ads MCP Server provides solid setup documentation but lacks public documentation on prompts, explicit tools, and resources. Its key strength is ease of integration and clear credential management. Based on documentation completeness and transparency, I would rate this MCP server a 5/10.

MCP Score