# pipeboard-co/meta-ads-mcp [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/pipeboard-co/meta-ads-mcp  
**GitHub Stars:** 1252  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pipeboard-co-meta-ads-mcp

## Description
Meta Ads automation that just works. Trusted by 10,000+ businesses to analyze performance, test creatives, optimize spend, and scale results — simply and reliably.

## Tools
Capabilities this server exposes over MCP:

- **user_id** — Meta user ID or "me" for the current user
- **limit** — Maximum number of accounts to return (default: 200)
- **account_id** — Meta Ads account ID (format: act_XXXXXXXXX)
- **status_filter** — Filter by status (empty for all, or 'ACTIVE', 'PAUSED', etc.)
- **campaign_id** — Meta Ads campaign ID
- **name** — Campaign name
- **objective** — Campaign objective (ODAX, outcome-based). Must be one of:
- **status** — Initial campaign status (default: PAUSED)
- **special_ad_categories** — List of special ad categories if applicable
- **daily_budget** — Daily budget in account currency (in cents)
- **lifetime_budget** — Lifetime budget in account currency (in cents)
- **bid_strategy** — Bid strategy. Must be one of: `LOWEST_COST_WITHOUT_CAP`, `LOWEST_COST_WITH_BID_CAP`, `COST_CAP`, `LOWEST_COST_WITH_MIN_ROAS`.
- **adset_id** — Meta Ads ad set ID
- **targeting** — Targeting specifications (e.g., age, location, interests)
- **optimization_goal** — Conversion optimization goal (e.g., 'LINK_CLICKS')
- **billing_event** — How you're charged (e.g., 'IMPRESSIONS')
- **bid_amount** — Bid amount in cents. Required for LOWEST_COST_WITH_BID_CAP, COST_CAP, TARGET_COST.
- **bid_constraints** — Bid constraints dict. Required for LOWEST_COST_WITH_MIN_ROAS (e.g., `{"roas_average_floor": 20000}`)
- **creative_id** — ID of an existing creative to use
- **tracking_specs** — Optional tracking specifications
- **ad_id** — Meta Ads ad ID
- **image_hash** — Hash of the uploaded image
- **page_id** — Facebook Page ID for the ad
- **link_url** — Destination URL
- **message** — Ad copy/text
- **headline** — Single headline for simple ads (cannot be used with headlines)
- **headlines** — List of headlines for dynamic creative testing (cannot be used with headline)
- **description** — Single description for simple ads (cannot be used with descriptions)
- **descriptions** — List of descriptions for dynamic creative testing (cannot be used with description)
- **dynamic_creative_spec** — Dynamic creative optimization settings
- **call_to_action_type** — CTA button type (e.g., 'LEARN_MORE')
- **instagram_actor_id** — Optional Instagram account ID
- **image_path** — Path to the image file to upload
- **frequency_control_specs** — List of frequency control specifications
- **object_id** — ID of the campaign, ad set, ad or account
- **time_range** — Time range for insights (default: maximum)
- **breakdown** — Optional breakdown dimension (e.g., age, gender, country)
- **level** — Level of aggregation (ad, adset, campaign, account)
- **budget_value** — Amount of budget increase
- **budget_value_type** — Type of budget value ("ABSOLUTE" or "MULTIPLIER")
- **time_start** — Unix timestamp for when the high demand period should start
- **time_end** — Unix timestamp for when the high demand period should end
- **query** — Search term for interests (e.g., "baseball", "cooking", "travel")
- **interest_list** — List of interest names to get suggestions for (e.g., ["Basketball", "Soccer"])
- **interest_fbid_list** — List of interest IDs to validate (e.g., ["6003700426513"])
- **demographic_class** — Type of demographics ('demographics', 'life_events', 'industries', 'income', 'family_statuses', 'user_device', 'user_os')
- **location_types** — Types of locations to search (['country', 'region', 'city', 'zip', 'geo_market', 'electoral_district'])

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "meta-ads-mcp": {
    "command": "npx",
    "args": ["-y","pipeboard-co-meta-ads-mcp"]
  }
}
```

## Documentation

## What pipeboard-co/meta-ads-mcp MCP server does

The pipeboard-co/meta-ads-mcp MCP server connects an MCP-compatible assistant to Meta advertising accounts. It covers the main hierarchy of Meta Ads objects: ad accounts, campaigns, ad sets, ads, and creatives. Supported workflows include creating campaigns, setting objectives and budgets, configuring targeting and optimization, uploading images, creating ads, and retrieving performance insights.

The server is intended for Facebook and Instagram advertising managed through Meta's advertising APIs. Campaigns can be created with an initial paused state, and ad configuration can include page IDs, destination URLs, copy, headlines, descriptions, tracking specifications, and dynamic creative settings.

## How it works

The recommended deployment is a hosted remote MCP service using the endpoint `https://meta-ads.mcp.pipeboard.co/`. An MCP client connects to that URL and discovers the available tools. The README identifies 42 Meta Ads tools covering campaigns, ad sets, ads, creatives, image uploads, insights, and several targeting-related operations.

Authentication is handled through Pipeboard. Users can complete an interactive login and connect a Facebook Ads account, or provide a Pipeboard API token through the endpoint URL. The remote approach avoids local server hosting and does not require a Meta developer token according to the project documentation.

Write operations use an explicit confirmation model, and newly created campaigns start paused where supported. This is relevant for agents that can both inspect account data and make changes, since analysis and mutation can occur in the same MCP session.

## Setup and configuration

For Claude, add the hosted URL as an integration and complete the Pipeboard and Facebook Ads login flow. Cursor users can place the endpoint in `~/.cursor/mcp.json` as a remote MCP server, then finish authentication when the client prompts for login. Other MCP clients can use the same remote URL if they support the required remote MCP transport.

The pipeboard-co/meta-ads-mcp MCP server can also accept a Pipeboard token in the URL for direct token authentication. The documented pattern is `https://meta-ads.mcp.pipeboard.co/?token=YOUR_PIPEBOARD_TOKEN`; the token is obtained from Pipeboard's API token page. No local environment variables are required for the hosted connection described in the README.

## Tools and capabilities

Available inputs cover common Meta Ads resource operations, including:

- Listing ad accounts for a Meta user, with account limits and status filters.
- Creating and updating campaigns with objectives, statuses, special ad categories, budgets, and bid strategies.
- Creating ad sets with targeting specifications, optimization goals, billing events, bids, and bid constraints.
- Creating ads from existing creatives or supplied image, page, URL, copy, headline, and description fields.
- Supporting single and dynamic creative variants through headline, description, tracking, and dynamic creative parameters.
- Uploading images and retrieving campaign performance insights.

Values such as budgets and bid amounts are supplied in cents in the account currency. Several fields are constrained by Meta-specific options, including campaign objectives, bid strategies, and optimization or billing settings.

## Limitations and notes

The hosted service depends on access to Pipeboard and a connected Meta Ads account. It is not a standalone local implementation in the recommended setup. Users choosing direct token authentication must protect the token because it is included in the connection URL.

The project documentation describes the repository as an independent open-source project using Meta's public APIs, while the hosted service is operated by Pipeboard. The provided material does not specify the repository's software license or provide a local installation command, so those details should not be assumed.

_Full upstream README: https://allmcps.com/mcp/pipeboard-co-meta-ads-mcp/readme_