Meta Ads API

Meta Ads MCP is a tool that allows AI models to access and manage the Meta Ads API through a standardized interface, supporting the acquisition of ad data, analysis of creative content, and provision of optimization suggestions.

Marketing Artificial intelligence chatbots #Ad analysis #Meta integration #AI optimization #Ad management .Python

rating : 2 points

downloads : 11

update time : 2025-04-15

What is Meta Ads MCP?

This is a bridge tool that connects AI models with the Meta Ads API, allowing you to query ad data, get optimization suggestions, and manage ad campaigns through natural language instructions. It is particularly suitable for marketers and business owners who want to gain advertising insights through AI.

How to use Meta Ads MCP?

Simply install the tool and connect your Meta Ads account, and you can directly query ad performance, get optimization suggestions, or adjust ad settings in any AI assistant that supports the MCP protocol (such as Claude).

Applicable scenarios

Digital marketing scenarios such as ad performance analysis, budget optimization decision-making, ad creative improvement, cross-platform ad management, and automated monitoring and alerting.

Main features

Ad campaign analysisAI automatically analyzes ad campaign performance, identifies key trends and optimization opportunities

Creative feedbackGet action suggestions for ad copy, images, and CTAs

Budget optimizationBudget allocation suggestions based on performance to maximize advertising return on investment

Cross-platform managementUnified management of ad campaigns on Meta platforms such as Facebook and Instagram

Ad visualizationView ad creatives and key metric charts directly in the chat interface

Advantages and limitations

Advantages

Obtain professional-level ad analysis without programming

Seamless integration with common AI assistants

Support real-time data query and visualization

Provide actionable optimization suggestions

Secure authentication process to protect account security

Limitations

Requires a Meta developer account for initial setup

Some advanced features require ad account permissions

Non-official tool, functions may be adjusted with API changes

How to use

Install the tool

Install the meta-ads-mcp package via pip or uv

Create a Meta developer app

Configure the AI client

Add MCP server configuration to clients such as Claude or Cursor

Start using

Query or manage ad campaigns through natural language instructions

Usage examples

Diagnose ad performance issuesWhen you find that the CTR of a certain ad campaign has dropped, let the AI analyze the possible reasons

Optimize budget allocationAutomatically adjust budget allocation based on ad performance

Frequently asked questions

What permissions are required to use this tool?

How is data security ensured?

Which Meta Ads platforms are supported?

Related resources

Meta developer documentation

Official Meta developer resources

MCP protocol official website

Standard documentation for the Model Context Protocol

GitHub repository

Project source code

🚀 Meta Ads Management Tool User Guide

This guide provides detailed instructions on installing, configuring, and using the Meta Ads Management Tool.

🚀 Quick Start

📦 Installation

Install the required Python packages for the Meta Ads Management Tool:

pip install meta-ads-mcp

⚙️ Configuration

It is recommended to set the following environment variables for convenient use:

Set the default App ID

Run the following command in the terminal:

export META_APP_ID=your_app_id

Set the default access token

If you already have a valid access token, you can skip the OAuth authentication process:

export META_ACCESS_TOKEN=your_access_token

ℹ️ Get Help

View the tool's usage instructions and version information:

uvx meta-ads-mcp --help
uvx meta-ads-mcp --version

✨ Features

The Meta Ads Management Tool offers the following core features:

👨‍💼 Ad Account Management

Get all available ad accounts:
```
uvx meta-ads-mcp get-ad-accounts
```

Check specific ad account information:

uvx meta-ads-mcp check-account-info --account-id=your_account_id

🎯 Ad Campaign Operations

Create a new ad campaign:

uvx meta-ads-mcp create-campaign --name="Your Campaign Name" --objective=CPC

Get a list of all ad campaigns:
```
uvx meta-ads-mcp get-campaigns
```

👥 Ad Set Management

Create a new ad set:

uvx meta-ads-mcp create-ad-set --campaign-id=your_campaign_id --name="Your Ad Set Name"

Get all ad sets:
```
uvx meta-ads-mcp get-ad-sets
```

📚 Documentation

👨‍💼 Account-related Commands

uvx meta-ads-mcp get-ad-accounts --help
uvx meta-ads-mcp check-account-info --account-id=ACCOUNT_ID --help

🎯 Ad Campaign Commands

uvx meta-ads-mcp create-campaign --name=CAMPAIGN_NAME --objective=OBJECTIVE [--start-time=START_TIME] [--end-time-END_TIME] --help
uvx meta-ads-mcp get-campaigns --status STATUS --fields.Fields --limit.LIMIT --help

👥 Ad Set Commands

uvx meta-ads-mcp create-ad-set --campaign-id=CAMPAIGN_ID --name=AD_SET_NAME [--optimization-OPTIMIZATION] [--bid-strategy=BID_STRATEGY] --help
uvx meta-ads-mcp get-ad-sets --status STATUS --fields.Fields --limit.LIMIT --ad setId AD_SET_ID --help

🔐 Authentication Issues

❌ Common Authentication Errors

If you encounter an error like (#200) Provide valid app ID, please check the following:

Ensure that you have correctly set up your Meta developer application.
Verify that you are passing the app ID correctly, either by:
- Setting an environment variable: export META_APP_ID=your_app_id
- Using it as a command-line parameter: uvx meta-ads-mcp --app-id your_app_id

🔑 Access Token Management

Get a new access token:
```
uvx meta-ads-mcp get-access-token
```
Refresh an existing token:
```
uvx meta-ads-mcp refresh-token
```

🔧 Debugging

📝 Logging

The tool enables logging by default. Log files are located in the ~/.meta_ads_mcp/logs/ directory.

🐞 Error Reporting

When encountering issues, please provide the following information:

The full error log.
The relevant operation steps.
Details of the environment configuration (including Python version and package versions).

🧪 Testing and Verification

🧪 Run Test Cases

uvx meta-ads-mcp run-tests

📖 View Code Documentation

uvx meta-ads-mcp view-docs

🚧 Troubleshooting

🌐 Network Issues

If you encounter network connection problems, please check:

Ensure that your internet connection is working properly.
Check your firewall settings to allow communication on the necessary ports.

⏳ Data Synchronization Delays

Some operations may experience data synchronization delays. It is recommended to wait a few minutes before performing critical operations and ensure that you are using the latest ad data.