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.
Basic information
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.
More Data & Analytics MCP servers
Google Ads MCP
cohnenAn MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th
arxiv-latex MCP Server
takashiishidaMCP server that uses arxiv-to-prompt to fetch and process arXiv LaTeX sources for precise interpretation of mathematical expressions in scientific papers.
HubSpot MCP Server
peakmojoA Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.
Federal Reserve Economic Data MCP Server
stefanoamorelliOpen-source FRED MCP Server (Federal Reserve Economic Data)
Bright Data MCP
brightdata-comA powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.
Comments