Advertise
MCP.so
Sign In
M

Meta Ads Insights Macp MCP Server

@ncklrs

Repository

Basic information

Category

Data & Analytics

Transports

stdio

Author

ncklrs

Submitted by

Nick Jensen

About Meta Ads Insights Macp MCP Server

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

Meta Ads Insights Macp MCP Server 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"
      }
    }
  }
}

Meta Ads Insights Macp MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What permissions does my Meta access token need?

The token must have the `ads_read` permission.

2

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).

3

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`.

4

What API version is used?

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

5

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

More Data & Analytics MCP servers

Hologrow

Hologrow Inc

Hologrow is the e-commerce data layer for any AI

golfdata.online - verified golf clubs

Canary Tech Labs S.L.

Verified European golf clubs: facts, booking links and sources, each with a verified date. Read-only, no key. Tools: search_clubs, get_club, list_sources_for. Every fact carries its source URL and a last-verified date. E

Instagram MCP Server

HasData

Read public Instagram profiles and post feeds by handle in Claude, Cursor, and other MCP clients. Get follower counts, captions, hashtags, mentions, and engagement counts as structured JSON.

23

TikTok MCP Server

HasData

Hosted TikTok MCP server for AI agents: read public profiles, account videos, comments and replies, or search videos and creators. Structured JSON for creator research and content analysis.

3

YouTube MCP Server

HasData

Hosted YouTube MCP server for search, video metadata, channel data and timestamped transcripts. Connect Claude, Cursor or other MCP clients with HasData; no YouTube API key required.

6
Advertise