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.

Local serverstdio

What is the Meta Ads Insights Macp MCP Server?

Meta Ads Insights Macp is an MCP project maintained in the ncklrs/meta-insights-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for accessing Meta (Facebook) Ads insights data with built-in support for joining with HubSpot deal data”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using node. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares META_ACCESS_TOKEN, META_AD_ACCOUNT_ID, META_API_VERSION. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_ad_insights
get_campaigns
get_adsets
prepare_hubspot_join

How to install the Meta Ads Insights Macp MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
META_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation
META_AD_ACCOUNT_IDDeclared in the maintainer’s client configuration.Check documentation
META_API_VERSIONDeclared in the maintainer’s client configuration.Check documentation