What is Mcp Facebook

MCP-Facebook is a specialized MCP server designed for managing and evaluating advertising campaigns on Facebook using Claude AI. It provides an interface for communication with the Facebook Marketing API, enabling the creation, management, and analysis of ad campaigns.

Use cases

Use cases include creating and managing Facebook ad campaigns, analyzing campaign performance, generating reports for stakeholders, and leveraging AI to optimize ad strategies and audience targeting.

How to use

To use MCP-Facebook, clone the repository, install dependencies, configure the necessary environment variables in a .env file, compile TypeScript, and start the server. Integration with Claude Desktop requires additional configuration in its settings.

Key features

Key features include campaign management (creating, listing, modifying, and deleting campaigns), analytics and reporting (performance overview, campaign comparison, account analysis, demographic audience analysis), audience management (creating custom and lookalike audiences), and AI assistance (prompt templates, performance analysis, optimization recommendations).

Where to use

MCP-Facebook can be used in digital marketing, advertising agencies, and any business that relies on Facebook for advertising. It is particularly useful for marketers looking to optimize their ad campaigns using AI.

Facebook Ads MCP Server

This project provides a Model Context Protocol (MCP) server designed to interact with the Facebook Marketing API, allowing AI assistants like Claude to manage and analyze Facebook ad campaigns, ad sets, audiences, and more.

Features

• Campaign Management: Create, read, update, delete campaigns.
• Audience Management: Create custom and lookalike audiences, list audiences.
• Ad Set Management: Create ad sets (basic implementation).
• Analytics: Get campaign insights.
• AI Assistance: Generate prompts for campaign creation based on templates.

Prerequisites

• Node.js (v18 or later recommended)
• npm (comes with Node.js)
• A Facebook App with access to the Marketing API
• A Facebook Ad Account ID
• An Access Token with ads_management and ads_read permissions

Installation

1. Clone the repository:

   git clone https://github.com/Tisik79/MCP-Facebook.git
   cd MCP-Facebook
   

2. Install dependencies:

   npm install
   

3. Configure Environment Variables:
   Create a .env file in the project root and add your Facebook App credentials:

   FACEBOOK_APP_ID=YOUR_APP_ID
   FACEBOOK_APP_SECRET=YOUR_APP_SECRET
   FACEBOOK_ACCESS_TOKEN=YOUR_ACCESS_TOKEN 
   FACEBOOK_ACCOUNT_ID=act_YOUR_ACCOUNT_ID 
   

   Replace placeholders with your actual values. Ensure the Access Token has the ads_management permission.

Usage

1. Build the server:

   npm run build
   

   This compiles the TypeScript code to JavaScript in the dist folder.

2. Run the server:

   npm start
   

   The server will start and listen for MCP connections via stdio.

3. Connect with an MCP Client (e.g., Claude Desktop):
   Follow the instructions in CLAUDE_DESKTOP_GUIDE.md to configure your MCP client to connect to this server using the npm start command or by directly running node dist/index.js.

Available Tools (via MCP)

• create_campaign: Creates a new ad campaign.
• get_campaigns: Lists existing campaigns.
• get_campaign_details: Gets details for a specific campaign.
• update_campaign: Updates an existing campaign.
• delete_campaign: Deletes a campaign.
• create_custom_audience: Creates a custom, website, or engagement audience.
• get_audiences: Lists available custom audiences.
• create_lookalike_audience: Creates a lookalike audience.
• create_ad_set: Creates a new ad set.
• get_campaign_insights: Retrieves performance insights for a campaign.
• generate_campaign_prompt: Generates a prompt for campaign creation using a template.

Refer to the server’s tool descriptions in your MCP client for detailed parameter information.

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues.

License

This project is licensed under the MIT License.