MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.
MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features. Exposed over MCP by the facebook ads mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.
Everything the assistant can do here goes through one of these:
list_ad_accounts — Lists ad accounts linked to the tokenget_details_of_ad_account — Retrieves details for a specific ad accountget_campaign_by_id — Retrieves details for a specific campaignget_adset_by_id — Retrieves details for a specific ad setget_ad_by_id — Retrieves details for a specific adget_ad_creative_by_id — Retrieves details for a specific ad creativeget_adsets_by_ids — Retrieves details for multiple ad sets by their IDsget_campaigns_by_adaccount — Retrieves campaigns within an ad accountget_adsets_by_adaccount — Retrieves ad sets within an ad accountget_ads_by_adaccount — Retrieves ads within an ad accountget_adsets_by_campaign — Retrieves ad sets within a campaignget_ads_by_campaign — Retrieves ads within a campaignYou will need one environment variable: YOUR_META_ACCESS_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
requirements.txt 1. (Optional but Recommended) Create and Activate a Virtual Environment: Using a virtual environment helps manage project dependencies cleanly[Source]. 2. Install Dependencies: 3. Obtain Meta Access Token: Secure a Meta User Access Token with the necessary permissions (e.g.Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Facebook Ads's toolset — list_ad_accounts, get_details_of_ad_account, get_campaign_by_id and 11 more — is a fair guide to whether it matches your workflow.
This entry was verified against Facebook Ads's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| list_ad_accounts | Lists ad accounts linked to the token. |
| get_details_of_ad_account | Retrieves details for a specific ad account. |
| get_campaign_by_id | Retrieves details for a specific campaign. |
| get_adset_by_id | Retrieves details for a specific ad set. |
| get_ad_by_id | Retrieves details for a specific ad. |
| get_ad_creative_by_id | Retrieves details for a specific ad creative. |
| get_adsets_by_ids | Retrieves details for multiple ad sets by their IDs. |
| get_campaigns_by_adaccount | Retrieves campaigns within an ad account. |
| get_adsets_by_adaccount | Retrieves ad sets within an ad account. |
| get_ads_by_adaccount | Retrieves ads within an ad account. |
| get_adsets_by_campaign | Retrieves ad sets within a campaign. |
| get_ads_by_campaign | Retrieves ads within a campaign. |
| get_ads_by_adset | Retrieves ads within an ad set. |
| get_ad_creatives_by_ad_id | Retrieves creatives associated with an ad. |
{
"mcpServers": {
"facebook-ads": {
"command": "npx",
"args": ["-y", "@smithery/cli"],
"env": {
"YOUR_META_ACCESS_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
requirements.txt 1. (Optional but Recommended) Create and Activate a Virtual Environment: Using a virtual environment helps manage project dependencies cleanly[Source]. 2. Install Dependencies: 3. Obtain Meta Access Token: Secure a Meta User Access Token with the necessary permissions (e.g.| Variable | Description | Required |
|---|---|---|
| YOUR_META_ACCESS_TOKEN | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.