Home / MCP / Meta Ads MCP Server
Provides an AI-driven interface to query Meta Ads data, optimize campaigns, and manage creatives via MCP clients.
Configuration
View docs{
"mcpServers": {
"meta_ads_remote": {
"url": "https://mcp.pipeboard.co/meta-ads-mcp"
}
}
}You can analyze, manage, and optimize Meta advertising campaigns through an AI-powered MCP server that connects to Meta Ads data. This server lets you retrieve performance metrics, visualize creatives, and receive strategic recommendations across Facebook, Instagram, and other Meta platforms using any MCP client.
Connect your MCP client to the remote Meta Ads MCP endpoint to start querying campaigns, ad sets, ads, and creatives. Use the available endpoints to fetch accounts, campaigns, ad sets, and ads, then request insights, create or update campaigns, and upload creatives. You can ask your AI-powered client for performance analysis, budget optimization suggestions, and creative improvements. The remote setup handles authentication in the cloud, so you can focus on insights and actions without managing local tokens.
Prerequisites: you will need an MCP client capable of connecting to an HTTP MCP endpoint. The fastest and simplest path is to use the Meta Ads MCP remotely, which requires no local setup.
If you prefer to run locally, you can self-host the MCP server. Follow a sensible flow: clone the source, install dependencies, and run the server. Be prepared to create a Meta Developer App and configure OAuth if you want full local operation.
Remote MCP (Recommended) Simply connect your MCP client to the remote URL: https://mcp.pipeboard.co/meta-ads-mcp. No local token storage is required because authentication is handled in the cloud.
Local Installation (Advanced Technical Users) If you self-host, you will need to set up a Meta Developer App and configure the local runtime to interact with Meta APIs. This involves installing dependencies, starting the local HTTP API, and ensuring secure token handling on your machine.
Security practices focus on secure token management and automatic authentication handling. Remote MCP offloads authentication to the cloud, eliminating local token storage. Local installations cache tokens securely on your device.
Basic testing can be done by exercising the MCP endpoints with your preferred client. Verify account access, fetch campaign lists, and query insights to ensure the remote MCP connection works as expected.
If you encounter setup issues, the simplest path is to use the Remote MCP, which requires no local configuration. For local installation issues, ensure you have created a Meta Developer App and that your MCP client is correctly configured to reach the local endpoint.
Retrieve the list of ad accounts accessible by a user with optional caching of tokens and limit control.
Fetch detailed information about a specific Meta Ads account by account_id.
Return pages associated with a Meta Ads account, useful for linking pages to ads.
Obtain campaigns for an account with optional filtering by limit and status.
Get in-depth details for a particular campaign.
Create a new campaign with required account_id, name, objective, status, and budget settings.
List ad sets for an account with optional campaign filtering.
Retrieve detailed information about a specific ad set.
Create a new ad set with targeting, budgeting, and scheduling options.
Fetch ads for an account with optional filtering by campaign or ad set.
Create a new ad using an existing creative and attach to an ad set.
Get details for a specific ad.
Retrieve creative details for a given ad.
Create a new ad creative from an uploaded image hash with multiple fields for dynamic or simple ads.
Update an existing creative with new content or settings.
Upload an image to use in creatives and return image hash details.
Get, download, and visualize an ad image in one step.
Update an existing ad with new status or bid amount.
Update an ad set with new targeting, bid strategy, budget, and status.
Retrieve performance insights for a campaign, ad set, ad, or account with time range and breakdown options.
Provide a login link for Meta Ads authentication.
Create a budget schedule for a campaign to adjust spend during high-demand periods.
Search for interest targeting options by keyword.
Suggest related interests based on an existing list.
Validate interest names or IDs for targeting.
List available behavioral targeting options.
List demographic targeting options.
Search geographic targeting locations by a query.
Enhanced, generic search across accounts, campaigns, ads, and pages with automatic page search when relevant.