# 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
Run the MCP server with your Facebook access token:
```bash
fb-mcp-bratrax --fb-token YOUR_FACEBOOK_ACCESS_TOKEN
```
## 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/gomarble-ai/facebook-mcp",
"name": "fb-mcp-bratrax",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "facebook, ads, mcp, server, meta, marketing, api, advertising, insights, campaigns, dbt, bratrax",
"author": "GoMarble AI",
"author_email": "GoMarble AI <support@gomarble.ai>",
"download_url": "https://files.pythonhosted.org/packages/73/93/c051e6309f6cb508b1909569a21bf47d165d8ad1d61015a309583a184a44/fb_mcp_bratrax-1.0.1.tar.gz",
"platform": null,
"description": "# FB MCP Bratrax\r\n\r\nA Model Context Protocol (MCP) server for Facebook/Meta Ads API integration, enabling programmatic access to Meta Ads data and management features.\r\n\r\n## Features\r\n\r\n- **Ad Account Management**: List and get details of ad accounts\r\n- **Campaign Analytics**: Retrieve performance insights for campaigns, ad sets, and ads\r\n- **Comprehensive Insights**: Access detailed metrics including impressions, clicks, spend, CTR, and more\r\n- **Flexible Filtering**: Support for date ranges, breakdowns, and custom filtering\r\n- **Pagination Support**: Automatic handling of large result sets\r\n\r\n## Installation\r\n\r\n```bash\r\npip install fb-mcp-bratrax\r\n```\r\n\r\n## Usage\r\n\r\nRun the MCP server with your Facebook access token:\r\n\r\n```bash\r\nfb-mcp-bratrax --fb-token YOUR_FACEBOOK_ACCESS_TOKEN\r\n```\r\n\r\n## Requirements\r\n\r\n- Python 3.8+\r\n- Valid Facebook/Meta Ads API access token\r\n- `mcp>=1.6.0`\r\n- `requests>=2.32.3`\r\n\r\n## Available Tools\r\n\r\nThe server provides access to Facebook Ads API through various MCP tools including account insights, campaign management, ad set analytics, and creative management.\r\n\r\nFor detailed documentation and setup instructions, visit the project repository.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for Facebook/Meta Ads API integration enabling programmatic access to Meta Ads data",
"version": "1.0.1",
"project_urls": {
"Bug Reports": "https://github.com/gomarble-ai/facebook-mcp/issues",
"Community": "https://join.slack.com/t/ai-in-ads/shared_invite/zt-36hntbyf8-FSFixmwLb9mtEzVZhsToJQ",
"Documentation": "https://github.com/gomarble-ai/facebook-mcp/blob/main/readme.md",
"Homepage": "https://gomarble.ai/mcp",
"Repository": "https://github.com/gomarble-ai/facebook-mcp"
},
"split_keywords": [
"facebook",
" ads",
" mcp",
" server",
" meta",
" marketing",
" api",
" advertising",
" insights",
" campaigns",
" dbt",
" bratrax"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "cab4f9b4e15b4bebada02dc6a88a711ad13a770bf36b4efa61f963191d3a8dd9",
"md5": "a3592af74f5ec30fa8b13fc878e8b846",
"sha256": "0706f5b33594bb9a2655a6c1cc9cd83a61b57f3b74d0929e5c5f27a29de02ad4"
},
"downloads": -1,
"filename": "fb_mcp_bratrax-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a3592af74f5ec30fa8b13fc878e8b846",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18567,
"upload_time": "2025-08-18T11:25:11",
"upload_time_iso_8601": "2025-08-18T11:25:11.664942Z",
"url": "https://files.pythonhosted.org/packages/ca/b4/f9b4e15b4bebada02dc6a88a711ad13a770bf36b4efa61f963191d3a8dd9/fb_mcp_bratrax-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7393c051e6309f6cb508b1909569a21bf47d165d8ad1d61015a309583a184a44",
"md5": "06bfbee319d4fa5762b4abda75cbc853",
"sha256": "72feb2cf1776ba9b341349ba9920f61803285b005532a2be5d0b699e944c28b1"
},
"downloads": -1,
"filename": "fb_mcp_bratrax-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "06bfbee319d4fa5762b4abda75cbc853",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25725,
"upload_time": "2025-08-18T11:25:12",
"upload_time_iso_8601": "2025-08-18T11:25:12.786825Z",
"url": "https://files.pythonhosted.org/packages/73/93/c051e6309f6cb508b1909569a21bf47d165d8ad1d61015a309583a184a44/fb_mcp_bratrax-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-18 11:25:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gomarble-ai",
"github_project": "facebook-mcp",
"github_not_found": true,
"lcname": "fb-mcp-bratrax"
}
JSON
