Instagram & Facebook MCP server for Meta Marketing API v25 with secure token redaction, cursor pagination, and OSS tooling for campaigns, ad sets, ads, creatives, insights, and reports.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"meta-ads-armavita": {
"env": {
"META_ACCESS_TOKEN": "EA...",
"META_GRAPH_API_VERSION": "v25.0"
},
"command": "armavita-meta-ads-mcp"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
armavita-meta-ads-mcp is a local Model Context Protocol server for Meta Ads. It is built for local MCP clients (Claude Code, Cursor, Codex) and supports:
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'armavita-meta-ads-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked armavita-meta-ads-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in marketing
DataForSEO API modelcontextprotocol server
MCP server for Mindbox CDP API — customer profiles, orders, segments. 3 tools.
MCP server for Yandex.Direct API — campaigns, ads, statistics, keywords. Bearer token auth.
一键同步文章到多个内容平台,支持今日头条、WordPress、知乎、简书、掘金、CSDN、typecho各大平台,一次发布,多平台同步发布。解放个人生产力
MCP Security Weekly
Get CVE alerts and security updates for Armavita Meta Ads Mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Brought to you by ArmaVita.com
Need a custom implementation? Contact us.
armavita-meta-ads-mcp is a local Model Context Protocol server for Meta Ads.
It is built for local MCP clients (Claude Code, Cursor, Codex) and supports:
META_ACCESS_TOKEN)META_APP_ID + META_APP_SECRET)3.11+mcp[cli]==1.27.2v25.0 by default (META_GRAPH_API_VERSION override supported)Current contract version: 1.2.0 (78 tools).
The default OAuth scope (META_AUTH_SCOPE) requests ads_management, ads_read, business_management, public_profile, pages_show_list, pages_read_engagement, instagram_basic, and threads_business_basic. The catalog tools additionally require catalog_management — add it to META_AUTH_SCOPE if you use them.
From PyPI (once published):
pip install armavita-meta-ads-mcp
From source (recommended during development):
uv sync
armavita-meta-ads-mcp
Module entrypoint:
python -m armavita_meta_ads_mcp
Login flow:
armavita-meta-ads-mcp --login
Minimal MCP server registration (JSON format used by many clients):
{
"mcpServers": {
"meta-ads-armavita": {
"command": "armavita-meta-ads-mcp",
"env": {
"META_ACCESS_TOKEN": "EA...",
"META_GRAPH_API_VERSION": "v25.0"
}
}
}
}
OAuth mode (no direct token in config):
{
"mcpServers": {
"meta-ads-armavita": {
"command": "armavita-meta-ads-mcp",
"env": {
"META_APP_ID": "YOUR_APP_ID",
"META_APP_SECRET": "YOUR_APP_SECRET"
}
}
}
}
Then run once to complete login:
armavita-meta-ads-mcp --login
Beyond the core auth variables above, the server reads four optional knobs:
| Variable | Default | Effect |
|---|---|---|
META_LOGIN_CONFIG_ID | unset | Facebook Login for Business configuration ID appended to the OAuth authorization URL. |
META_ADS_DISABLE_CALLBACK_SERVER | unset | Set to any value to disable the local OAuth callback server (token/OAuth login flows will error instead of opening a port). |
META_MCP_DR_CAMPAIGN_SCAN_LIMIT | 10 | Number of ad accounts whose campaigns are scanned by search_web_content research queries. |
META_MCP_DISABLE_DELIVERY_FALLBACK | 1 | Set to 0 to let estimate_audience_size fall back to the delivery_estimate edge when reachestimate returns an error. |
list_ad_accounts, read_ad_account, get_account_controls, update_account_controls, list_account_pages, search_pageslist_campaigns, read_campaign, create_campaign, update_campaign, create_campaign_budget_schedulelist_ad_sets, read_ad_set, create_ad_set, update_ad_setlist_ads, read_ad, create_ad, update_ad, list_ad_previewslist_ad_creatives, read_ad_creative, create_ad_creative, update_ad_creativeupload_ad_image_asset, upload_ad_video_asset, read_ad_image, export_ad_image_filelist_ad_images, list_ad_videoslist_insights, create_reportcreate_insights_job, read_insights_job, read_insights_job_resultslist_ad_custom_derived_metricslist_custom_conversions, read_custom_conversion, create_custom_conversion, update_custom_conversion, delete_custom_conversion