Skip to main content

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.

Metadata

Release files for fb-mcp-bratrax 1.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fb-mcp-bratrax 1.1.2
File Size Uploaded
fb_mcp_bratrax-1.1.2.tar.gz 27.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fb-mcp-bratrax 1.1.2
File Interpreter ABI Platform
fb_mcp_bratrax-1.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 47.6 kB

Release files / fb_mcp_bratrax-1.1.2.tar.gz

Download URL fb_mcp_bratrax-1.1.2.tar.gz
Size 27.4 kB
Tags Source
SHA-256 checksum
How to use checksums
e7fd7d4e94d158050de4f6d574a5fc877a687ba806ca1bd9dbba13713a186fbd
BLAKE2b-256 checksum
How to use checksums
6435ad5ae32beded27dc83b6b9fb062fbd3b4eed2662a47b30ecaf584c4842b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.6

Release files / fb_mcp_bratrax-1.1.2-py3-none-any.whl

Download URL fb_mcp_bratrax-1.1.2-py3-none-any.whl
Size 20.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fc8c780c1546f6e641c4b4d13109d1f7e4243acd27d29c1eb7242917c4d2ac50
BLAKE2b-256 checksum
How to use checksums
80cc481e6aa688add24b7009decb0abe7b082c297a0aa6ad431201cb85d06a76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.6

Release history Release notifications | RSS feed

This release

1.1.2 This release

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page