Meta Ads MCP

🚀 Meta Ads Multi Account Package

The Meta Ads Multi Account Package is a powerful tool that simplifies the management of multiple Meta advertising accounts, offering a variety of commands to handle different advertising operations.

🚀 Quick Start

Basic Usage Example

uvx meta-ads-mcp --app-id your_app_id

Get Advertising Account Information

To view all associated advertising accounts, run the following command:

uvx meta-ads-mcp --app-id your_app_id --get-ad_accounts

📦 Installation

Install via pip

pip install meta-ads-mcp

Install from Source Code

git clone https://github.com/your-repository/meta_ads_mcp.git
cd meta_ads_mcp
python setup.py install

📚 Documentation

Common Tool Commands

1. Get Login Link

Use the mcp_meta_ads_get_login_link tool to get a new authorization link:

mcp_meta_ads_get_login_link()

2. Query Advertising Account Information

List all associated advertising accounts:

mcp_meta_ads_get_ad_accounts()

List of Operation Tools

The following is a complete list of operation tools, each with specific functions:

Tool Overview

• Get Login Link: mcp_meta_ads_get_login_link()
• Query Advertising Account Information: mcp_meta_ads_get_ad_accounts()
• Get Account Details: mcp_meta_ads_get_account_info(account_id="your_account_id")
• Create a New Advertising Campaign: mcp_meta_ads_create_campaign(campaign_name="your_campaign_name", budget_type="daily", daily_budget=100.0, account_id="your_account_id")
• Delete an Advertising Campaign: mcp_meta_ads_delete_campaign(campaign_id="your_campaign_id", account_id="your_account_id")
• Get Advertising Campaigns: mcp_meta_ads_get_campaigns(account_id="your_account_id")
• Create a New Ad Set: mcp_meta_ads_create_ad_set(ad_set_name="your_ad_set_name", campaign_id="your_campaign_id", budget_type="daily", daily_budget=100.0, account_id="your_account_id")
• Delete an Ad Set: mcp_meta_ads_delete_ad_set(ad_set_id="your_ad_set_id", account_id="your_account_id")
• Get Ad Set Information: mcp_meta_ads_get_ad_sets(campaign_id="your_campaign_id")
• Create a New Ad: mcp_meta_ads_create_ad(creative_id="your_creative_id", title="your_title", description="your_description", url="your_url", ad_set_id="your_ad_set_id")
• Delete an Ad: mcp_meta_ads_delete_ad(ad_id="your_ad_id", ad_set_id="your_ad_set_id")
• Get All Creatives: mcp_meta_ads_get_creatives(account_id="your_account_id")

Environment Variable Configuration

Set the Application ID

Set the META_APP_ID environment variable:

export META_APP_ID=your_app_id
uvx meta-ads-mcp

Specify the Application ID via the Command Line

uvx meta-ads-mcp --app-id your_app_id

Login Methods

Local Cache Login

When running the tool for the first time, it will automatically launch the browser for authorization:

uvx meta-ads-mcp

Force Re-login

Use the --force-login flag to force a re-login:

uvx meta-ads-mcp --force-login

Debugging Guide

Image Download Debugging

If you need to download creative images, set the following:

export AD_CREATIVES_DOWNLOAD=1
mcp_meta_ads_get_creatives(account_id="your_account_id")

Logging

Enable logging to troubleshoot issues:

uvx meta-ads-mcp --log-file /path/to/logfile.log

Privacy and Security

Protection of Authentication Information

All authentication information is encrypted and stored, and will not be accessed by third parties. Avoid using this tool in a shared environment.

Data Transmission

Data is securely transmitted via HTTPS to ensure security during transmission.

Frequently Asked Questions

• How to re-obtain authorization? Use the --force-login flag to force a re-login.

• What if I forget the application ID? Check the environment variables or find your application ID in the Meta Ads Control Panel.

Documentation Expansion

For more detailed documentation, visit the project's official website or refer to relevant technical materials.