Metadata-Version: 2.4
Name: fb-mcp-bratrax
Version: 1.1.2
Summary: MCP server for Facebook/Meta Ads API integration enabling programmatic access to Meta Ads data
Home-page: https://github.com/gomarble-ai/facebook-mcp
Author: GoMarble AI
Author-email: GoMarble AI <support@gomarble.ai>
License: MIT
Project-URL: Homepage, https://gomarble.ai/mcp
Project-URL: Repository, https://github.com/gomarble-ai/facebook-mcp
Project-URL: Bug Reports, https://github.com/gomarble-ai/facebook-mcp/issues
Project-URL: Documentation, https://github.com/gomarble-ai/facebook-mcp/blob/main/readme.md
Project-URL: Community, https://join.slack.com/t/ai-in-ads/shared_invite/zt-36hntbyf8-FSFixmwLb9mtEzVZhsToJQ
Keywords: facebook,ads,mcp,server,meta,marketing,api,advertising,insights,campaigns,dbt,bratrax
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Communications
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.6.0
Requires-Dist: requests>=2.32.3
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 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

```bash
pip install fb-mcp-bratrax
```

## Usage

Set your Facebook access token as an environment variable and run the MCP server:

### Windows (PowerShell):

```powershell
$env:FB_TOKEN = "YOUR_FACEBOOK_ACCESS_TOKEN"
fb-mcp-bratrax
```

### Windows (Command Prompt):

```cmd
set FB_TOKEN=YOUR_FACEBOOK_ACCESS_TOKEN
fb-mcp-bratrax
```

### Linux/macOS:

```bash
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.
