Facebook Ads 10xeR

Facebook Ads 10xeR

MCP server providing Facebook Ads data, insights, and account management via natural language.

3
Stars
0
Forks
0
Releases

Overview

Facebook Ads MCP Server is a Model Context Protocol (MCP) server that enables Claude and other MCP clients to access Facebook advertising data, insights, and account information through natural language conversations. It supports OAuth-based authentication, token management, and session handling, with production security ensuring hardcoded tokens are only allowed in test mode. The server exposes tools for listing ad accounts, retrieving account details and performance insights, and fetching ad activities, all with automatic pagination for large datasets. Configuration is performed via Claude Desktop MCP settings and environment variables (e.g., FACEBOOK_ACCESS_TOKEN). The project architecture includes modular components under src/tools for common operations like listing accounts, fetching pagination data, and obtaining insights, together with utilities for Facebook API access and error handling. Typical workflows involve obtaining a Facebook access token with permissions such as ads_read, ads_management, and business_management, then configuring the MCP client to use commands like facebook_list_ad_accounts, facebook_get_adaccount_insights, and related tools.

Details

Owner
fortytwode
Language
JavaScript
License
Updated
2025-12-07

Features

OAuth Login

Secure browser-based Facebook authentication.

Token Management

Automatic secure token storage and retrieval.

Session Management

Login, logout, and authentication status checking.

Production Security

Hardcoded tokens only allowed in test mode (NODE_ENV=test).

List Ad Accounts

Get all accessible Facebook ad accounts.

Account Details

Get detailed information about specific ad accounts.

Account Insights & Activities

Retrieve performance metrics, analytics data, and activity logs for ad accounts.

Pagination Support

Handle large datasets with automatic pagination.

Audience

AdvertisersAccess and analyze Facebook ad accounts and performance through natural language conversations.
DevelopersIntegrate MCP server with Claude or other clients to fetch ads data via API.

Tags

Facebook AdsMCP ServerClaudeOAuthAd AccountsInsightsAnalyticsPagination