FB MCP Bratrax
A Model Context Protocol (MCP) server for Facebook/Meta Ads API integration, enabling programmatic access to Meta Ads data and management features.
Features
- Ad Account Management: List and get details of ad accounts
- Campaign Analytics: Retrieve performance insights for campaigns, ad sets, and ads
- Comprehensive Insights: Access detailed metrics including impressions, clicks, spend, CTR, and more
- Flexible Filtering: Support for date ranges, breakdowns, and custom filtering
- Pagination Support: Automatic handling of large result sets
Installation
pip install fb-mcp-bratrax
Usage
Set your Facebook access token as an environment variable and run the MCP server:
Windows (PowerShell):
$env:FB_TOKEN = "YOUR_FACEBOOK_ACCESS_TOKEN"
fb-mcp-bratrax
Windows (Command Prompt):
set FB_TOKEN=YOUR_FACEBOOK_ACCESS_TOKEN
fb-mcp-bratrax
Linux/macOS:
export FB_TOKEN=YOUR_FACEBOOK_ACCESS_TOKEN
fb-mcp-bratrax
Requirements
- Python 3.8+
- Valid Facebook/Meta Ads API access token
mcp>=1.6.0
requests>=2.32.3
Available Tools
The server provides access to Facebook Ads API through various MCP tools including account insights, campaign management, ad set analytics, and creative management.
For detailed documentation and setup instructions, visit the project repository.