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.
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.
Basic information
More Data & Analytics MCP servers
Batru
BatruReal, calibrated win-rate predictions, pick recommendations, counters, synergy and tier lists for Dota 2, Deadlock and Marvel Rivals, from production models trained on ~20M matches. Free hosted endpoint (Streamable HTTP)
AskRentAI
AskRentAIAsk your Rent Manager property portfolio anything, from the AI you already use. AskRentAI is a hosted, read-only MCP server for Rent Manager, the property management platform used across a large share of US rental housi
CryptoStruct Market Data
cryptostructRemote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage), free sample files, and tick-data. Keyless for catalog & stats; opt
World Monitor
Elie HabibLive global-intelligence MCP server covering news, markets, conflicts, aviation, maritime activity, energy, climate, cyber threats, supply chains, and source-grounded regional briefs.
Jitsu
JitsuJitsu is an open-source Customer Data Platform — an MIT-licensed alternative to Segment. This MCP server gives your AI assistant direct control over a Jitsu workspace, so you can run and debug data pipelines in conversat
Comments