Facebook Ads MCP Server

What is Facebook Ads MCP Server?

An MCP server acting as an interface to the Meta Ads platform, enabling programmatic access to Meta Ads data and management features.

How to use Facebook Ads MCP Server?

Install via Smithery (npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude) or manually set up Python 3.10+, install dependencies, obtain a Meta Access Token, and configure an MCP client (e.g., Cursor, Claude Desktop) with the provided JSON snippet. A one‑click installer is also available at gomarble.ai/mcp.

Key features of Facebook Ads MCP Server

• Automated environment setup and dependency installation.
• Optional Meta token authentication; GoMarble can create a token.
• Token stored locally; GoMarble does not store it.
• Tools for reading accounts, campaigns, ads, and creatives.
• Tools for fetching performance insights with pagination and filters.
• Change history retrieval for ad accounts and ad sets.

Use cases of Facebook Ads MCP Server

• Programmatically list and inspect ad accounts, campaigns, ad sets, and ads.
• Retrieve performance insights (e.g., metrics) for any Meta Ads object.
• Fetch change history to audit ad account or ad set modifications.
• Automate campaign monitoring and reporting via MCP‑compatible clients.

FAQ from Facebook Ads MCP Server

Do I need to manually obtain a Meta Developer Access Token?

No. The setup connects to GoMarble’s server to create the token on your behalf; you are not required to manually obtain a Meta Developer Access Token.

Where is my Meta access token stored?

The token is saved locally on your machine. GoMarble does not store it.

What happens if my token expires?

You must generate a new Meta access token and update the MCP client configuration with the new token to continue using the tools.

What are the prerequisites?

Python 3.10+ and the dependencies listed in requirements.txt (mcp >=1.6.0, requests >=2.32.3).

How can I install the server?

You can install via Smithery, download the one‑click installer from gomarble.ai/mcp, or follow the manual setup instructions (clone repo, install dependencies, configure token).