Armavita Meta Ads MCP Server
Meta Marketing API access for local AI clients managing campaigns and ads.
Data last scanned today · Reviewed today
Overview
This server provides a local Model Context Protocol interface for the Meta Marketing API, allowing AI agents to interact directly with Facebook, Instagram, and Threads advertising data. It supports 78 distinct tools covering account management, campaign oversight, and audience estimation using Python 3.11+ environments. Users can configure the server using a direct access token or a local OAuth flow, with specific variables available to tune behavior like campaign scan limits or audience estimation fallback logic. It operates via stdio transport and is designed for local integration with MCP-compliant AI clients.
Our verdict
With a security score of 40/100, this tool is categorized as high risk. The server lacks a read-only mode, meaning any connected client is granted full write access to your Meta ad accounts, and it is maintained by an individual rather than an official vendor. Due to these factors, it is recommended only for power users who understand the implications of granting write permissions to an unofficial, third-party interface.
- Supports 78 distinct tools for comprehensive Meta API interaction.
- Zero direct dependencies reduces the supply-chain attack surface.
- Built-in local OAuth authentication flow options.
- Active development with a recent commit history.
- No read-only mode prevents restricting access to write actions.
- Community-maintained project lacking official Meta endorsement.
- High bus-factor risk with only one project contributor.
Tools
| Tool | Description | Risk |
|---|---|---|
| list_ad_accounts | Lists ad accounts associated with the user. | low |
| read_ad_account | Reads details of a specific ad account. | low |
| get_account_controls | Gets controls associated with an ad account. | low |
| update_account_controls | Updates controls for an ad account. | medium |
| list_account_pages | Lists pages associated with an ad account. | low |
| search_pages | Searches for pages. | low |
| list_campaigns | Lists campaigns. | low |
| read_campaign | Reads details of a campaign. | low |
| create_campaign | Creates a new campaign. | medium |
| update_campaign | Updates a campaign. | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the system requirements to run this MCP server?
This server requires Python 3.11 or higher and the mcp library version 1.27.2. It supports stdio as the only transport mechanism.
›How can I authenticate with the Meta API?
You can authenticate using a static META_ACCESS_TOKEN or by configuring a local OAuth flow with your META_APP_ID and META_APP_SECRET. If using OAuth, you must run the server with the --login flag to complete the authorization process.
›Do I need special permissions to use catalog tools?
Yes, the catalog tools require the catalog_management scope. You must add this permission to your META_AUTH_SCOPE environment variable.
›Can I disable the local OAuth callback server?
Yes, you can set the META_ADS_DISABLE_CALLBACK_SERVER environment variable to any value to disable the local callback server, though this will cause token or OAuth flows to error.
›How does pagination work for the provided tools?
The server supports cursor-based pagination for most list and read operations. You can navigate through results by using the page_cursor parameter provided by the API.
Badge
Maintain this server? Add the live badge to your README.