home / mcp / meta ads mcp server

Meta Ads MCP Server

Provides an MCP server to analyze, manage, and optimize Meta Ads campaigns via AI across Facebook, Instagram, and Meta platforms.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "pipeboard-co-meta-ads-mcp": {
      "url": "https://mcp.pipeboard.co/meta-ads-mcp"
    }
  }
}

You can connect to Meta Ads MCP to analyze, manage, and optimize your Meta advertising campaigns through an AI-driven interface. This MCP server provides access to Meta Ads data and a wide range of campaign, ad set, and creative management capabilities via MCP-compatible clients, enabling powerful insights and automation across Facebook, Instagram, and other Meta platforms.

How to use

Connect to the Meta Ads MCP using a remote MCP client to begin analyzing your ad campaigns. The service provides AI-powered analysis, performance insights, budget optimization recommendations, and cross-platform management for campaigns, ad sets, ads, and creatives. You can use it to retrieve data, visualize creatives, and get strategic recommendations from your preferred MCP client. Start by linking your Meta Ads account through the remote MCP URL and then issue MCP-enabled commands to fetch accounts, campaigns, ad sets, and ads, or to create and update campaigns and creatives. The MCP supports authenticated access via URL tokens or interactive login flows where supported by your client.

How to install

Prerequisites: none specific to the remote MCP. You simply need a compatible MCP client and internet access. The recommended setup is to use the remote MCP, which requires no local installation. If you prefer to self-host, you can explore local streamable HTTP transport options once you have the necessary environment set up.

Configuration

Remote MCP (recommended): to connect, use the remote MCP URL so you can access Meta Ads data without local setup. Advanced users may authenticate via direct token parameters in the URL when supported by their MCP client.

Security and privacy

Security relies on secure token handling and authenticated access. Remote MCP authentication happens in the cloud, with no local token storage required. Local installations cache tokens securely on your device. Always follow best practices for token management and restrict access to authorized users.

Testing

Test your connection by evaluating core data access and campaign operations through your MCP client. Verify you can retrieve ad accounts, view account details, and list campaigns. Use the available tools to confirm proper responses for accounts, campaigns, ad sets, ads, and creatives.

Troubleshooting

If you encounter setup issues, consider using the remote MCP for the easiest experience. It eliminates local configuration and token handling concerns. If you must self-host, ensure you follow the local setup instructions for your environment and verify authentication flow for your chosen MCP client.

Licensing

The Meta Ads MCP is licensed under the Business Source License 1.1, with usage allowances for individuals and businesses, and a transition to an open-source license on a future date. Review licensing terms for commercial use and redistribution rules.

Notes

The remote MCP URL to connect is provided for cloud access. If you need token-based direct authentication, you can append the token to the URL when supported by your MCP client.

Available tools

mcp_meta_ads_get_ad_accounts

Retrieve ad accounts accessible by a user, with optional token and limit parameters to list available accounts.

mcp_meta_ads_get_account_info

Fetch detailed information about a specific Meta Ads account using the account ID.

mcp_meta_ads_get_account_pages

Get the pages associated with a given Meta Ads account for ad creation and management.

mcp_meta_ads_get_campaigns

List campaigns for an account with optional filters such as limit and status.

mcp_meta_ads_get_campaign_details

Obtain comprehensive details for a specific campaign.

mcp_meta_ads_create_campaign

Create a new campaign in a chosen account with specified objective, budget, and settings.

mcp_meta_ads_get_adsets

Retrieve ad sets for an account with optional campaign filtering.

mcp_meta_ads_get_adset_details

Get detailed information about a specific ad set.

mcp_meta_ads_create_adset

Create a new ad set with targeting, budget, timing, and optimization settings.

mcp_meta_ads_get_ads

List ads within an account with optional campaign or ad set filtering.

mcp_meta_ads_create_ad

Create a new ad using an existing creative and assign it to an ad set.

mcp_meta_ads_get_ad_details

Fetch detailed information about a specific ad.

mcp_meta_ads_get_ad_creatives

Retrieve creative details for a specific ad, including text, images, and URLs.

mcp_meta_ads_create_ad_creative

Create a new ad creative by uploading an image hash and specifying destination details.

mcp_meta_ads_update_ad_creative

Update an existing ad creative with new content or settings.

mcp_meta_ads_upload_ad_image

Upload an image to use in ad creatives and obtain an image hash.

mcp_meta_ads_get_ad_image

Get and visualize a Meta Ads image associated with an ad.

mcp_meta_ads_update_ad

Update an existing ad with new status or bid information.

mcp_meta_ads_update_adset

Update an ad set with new settings including frequency controls and targeting.

mcp_meta_ads_get_insights

Fetch performance insights for campaigns, ad sets, ads, or accounts with optional breakdowns and time ranges.

mcp_meta_ads_get_login_link

Retrieve a clickable login link for Meta Ads authentication.

mcp_meta_ads_create_budget_schedule

Create a budget schedule to adjust campaign budgets during high-demand periods.

mcp_meta_ads_search_interests

Search for interest targeting options by keyword.

mcp_meta_ads_get_interest_suggestions

Get suggestions for additional interests based on existing ones.

mcp_meta_ads_validate_interests

Validate interest names or IDs for targeting accuracy.

mcp_meta_ads_search_behaviors

List available behavior targeting options for audience segmentation.

mcp_meta_ads_search_demographics

Fetch demographic targeting options across various classes.

mcp_meta_ads_search_geo_locations

Search geographic targeting locations by query and type.

mcp_meta_ads_search

Enhanced generic search across accounts, campaigns, ads, and pages with automatic page searching when relevant.