Meta Ads Insights Macp

@ncklrs

About Meta Ads Insights Macp

A Model Context Protocol (MCP) server for accessing Meta (Facebook) Ads insights data with built-in support for joining with HubSpot deal data.

#meta #facebook #instagram #ads

Config

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

{
  "mcpServers": {
    "meta-ads-insights": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/project/dist/index.js"
      ],
      "env": {
        "META_ACCESS_TOKEN": "your_meta_access_token_here",
        "META_AD_ACCOUNT_ID": "your_ad_account_id_without_act_prefix",
        "META_API_VERSION": "v19.0"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Meta Ads Insights Macp?

A Model Context Protocol (MCP) server for accessing Meta (Facebook) Ads insights data with built-in support for joining with HubSpot deal data. It is designed for marketers and analysts who need to correlate ad performance metrics with revenue outcomes in HubSpot.

How to use Meta Ads Insights Macp?

Install dependencies with npm install, build with npm run build, then configure Claude Desktop by adding the server to claude_desktop_config.json with environment variables for META_ACCESS_TOKEN, META_AD_ACCOUNT_ID, and META_API_VERSION. After configuration, invoke tools like get_ad_insights, get_campaigns, get_adsets, or prepare_hubspot_join via natural language prompts in Claude.

Key features of Meta Ads Insights Macp

Fetch ad insights with flexible filtering and breakdowns
Campaign and ad set management
Mobile placement tracking for revenue attribution
Prepare ads data for joining with HubSpot deals
Configurable access tokens via MCP configuration

Use cases of Meta Ads Insights Macp

Mobile Ads Revenue Attribution: correlate mobile ad spend to HubSpot deal revenue
Campaign Performance Analysis: identify highest-converting campaign and placement combinations
Join ad performance data with HubSpot deal data for closed-loop reporting

FAQ from Meta Ads Insights Macp

What permissions does my Meta access token need?

The token must have the ads_read permission.

How do I find my Ad Account ID?

In Meta Ads Manager, the account ID appears in the URL as act_1234567890; use just 1234567890 (without the act_ prefix).

How do I configure the server in Claude Desktop?

Add a configuration entry to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude), specifying the absolute path to dist/index.js and the required environment variables: META_ACCESS_TOKEN, META_AD_ACCOUNT_ID, and META_API_VERSION.

What API version is used?

The default is v19.0, configurable via the META_API_VERSION environment variable.

What should I do if the tools are not working?

Ensure the token has ads_read, the account ID is correct (no act_ prefix), the path in the config is absolute and correct, and restart Claude Desktop after any configuration changes.

Frequently asked questions

What permissions does my Meta access token need?

The token must have the `ads_read` permission.

How do I find my Ad Account ID?

In Meta Ads Manager, the account ID appears in the URL as `act_1234567890`; use just `1234567890` (without the `act_` prefix).

How do I configure the server in Claude Desktop?

Add a configuration entry to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude`), specifying the absolute path to `dist/index.js` and the required environment variables: `META_ACCESS_TOKEN`, `META_AD_ACCOUNT_ID`, and `META_API_VERSION`.

What API version is used?

The default is `v19.0`, configurable via the `META_API_VERSION` environment variable.

What should I do if the tools are not working?

Ensure the token has `ads_read`, the account ID is correct (no `act_` prefix), the path in the config is absolute and correct, and restart Claude Desktop after any configuration changes.

Comments

Basic information

More Data & Analytics MCP servers

🪐✨ Jupyter MCP Server

datalayer

🪐 🔧 Model Context Protocol (MCP) Server for Jupyter.

1.2K

Subtext

Subtext by Fullstory

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can