Advertise
MCP.so
Sign In

Facebook Ads MCP Server

@Tisik79

Repository

Basic information

Category

Other

Transports

stdio

Author

Tisik79

About Facebook Ads MCP Server

MCP server pro zadávání a vyhodnocování reklamních kampaní na Facebooku pomocí Claude AI

Facebook Ads MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCP-Facebook": {
      "command": "node",
      "args": [
        "dist/index.js",
        "login"
      ]
    }
  }
}

Facebook Ads MCP Server tools

30

Step-by-step connection guide

List campaigns

Create a new campaign

Update a campaign (incl. `bidStrategy`) — read-after-write

Campaign detail (budget, bid_strategy, spend today)

Delete a campaign

Campaign analytics

List ad sets

Create an ad set (incl. lead fields `promotedObject` / `destinationType`)

Update an ad set (name / status) — real write + read-after-write verification

List ads (filtered via adSetId/campaignId edge + status)

Ad detail incl. creative (link, CTA, copy, video/image)

Upload an image (`image_hash`) or video (`video_id`)

Create a creative from `object_story_spec`

Create an ad (defaults to PAUSED)

Update an ad (name/status/creative) — read-after-write

Delete an ad

Create an instant lead form on a page

List lead forms (`id`, `name`, `status`, `leads_count`)

Account pixels (`id`, `name`) for `promoted_object`

Pixel event statistics (verify events are flowing)

Behavior categories for targeting

Geo keys (region/city/zip) for `targeting.geo_locations`

Audience size estimate for a given targeting spec

Update a creative (name/status — content is immutable)

Custom audiences

Create an audience

Lookalike audience

Page post

Video page post (resumable upload, unpublished by default)

Overview

What is Facebook Ads MCP Server?

An MCP server that lets you manage Facebook Ads directly from Claude AI. It handles OAuth authentication so you sign in with Facebook once, and provides tools for campaigns, ad sets, ads, analytics, audiences, and page posts.

How to use Facebook Ads MCP Server?

Install Node.js 18+, clone the repository, run npm install && npm run build, then add the server to your Claude Desktop config file. On first run a wizard walks you through creating a Facebook App; after entering the App ID and Secret a browser opens for sign-in. Use node dist/index.js login to re-authenticate or add new pages.

Key features of Facebook Ads MCP Server

  • Campaign, ad set, and ad management (CRUD)
  • Analytics and insights at campaign, ad set, and ad level
  • Custom and lookalike audience creation
  • Page post creation (text and video)
  • Automatic, permanent page token management via OAuth

Use cases of Facebook Ads MCP Server

  • View and manage active campaigns from natural language prompts
  • Create campaigns with daily budgets and bid strategies
  • Analyze ad performance over a custom date range
  • Post updates to Facebook pages without leaving the chat
  • Build custom or lookalike audiences for targeting

Frequently asked questions

1

What are the system requirements?

Node.js 18+ and Claude Desktop are required.

2

How does authentication work?

On first run a wizard guides you through creating a Facebook App. Enter the App ID and App Secret, then a browser automatically opens for Facebook sign-in. No manual token collection is needed.

3

Are tokens refreshed automatically?

Yes — the server handles token management automatically, and page tokens are permanent after the initial OAuth flow.

4

What is required for lead campaigns?

Lead campaigns need `promotedObject` and `destinationType` on the ad set. For website leads use `destinationType=WEBSITE` with a pixel ID; for instant forms use `destinationType=ON_AD` with a page ID and lead form ID.

5

How does the Conversions API work?

The server sends server-side conversion events with automatic SHA-256 hashing of PII. It supports single and batch event sending, plus offline conversion sets from CRM data.

Comments

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise