Loading...

This MCP server provides an interface to Meta Ads, enabling programmatic access to data and management features, secured by a Meta access token.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
This MCP server provides an interface to Meta Ads, enabling programmatic access to data and management features, secured by a Meta access token.
This MCP server is relatively safe for read-only operations. However, the ability to modify ad campaigns introduces a moderate risk. Securely manage the Meta access token and monitor changes to ad campaigns to mitigate potential risks.
Performance depends on the Meta Ads API's response times and the volume of data being retrieved. Consider implementing caching to improve performance for frequently accessed data.
Cost is primarily associated with Meta Ads API usage, which may have rate limits and usage fees. Monitor API usage to avoid unexpected costs.
npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude{
"mcpServers": {
"fb-ads-mcp-server": {
"command": "python",
"args": [
"/path/to/your/fb-ads-mcp-server/server.py",
"--fb-token",
"YOUR_META_ACCESS_TOKEN"
]
// If using a virtual environment, you might need to specify the python executable within the venv:
// "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
// "args": [
// "/path/to/your/fb-ads-mcp-server/server.py",
// "--fb-token",
// "YOUR_META_ACCESS_TOKEN"
// ]
}
}
}list_ad_accountsLists ad accounts linked to the provided Meta access token.
Read-only operation, no modification of data.
get_details_of_ad_accountRetrieves detailed information for a specified ad account.
Read-only operation, no modification of data.
get_campaign_by_idRetrieves details for a specific ad campaign by its ID.
Read-only operation, no modification of data.
get_adset_by_idRetrieves details for a specific ad set by its ID.
Read-only operation, no modification of data.
get_ad_by_idRetrieves details for a specific ad by its ID.
Read-only operation, no modification of data.
get_ad_creative_by_idRetrieves details for a specific ad creative by its ID.
Read-only operation, no modification of data.
get_adsets_by_idsRetrieves details for multiple ad sets based on their IDs.
Read-only operation, no modification of data.
get_campaigns_by_adaccountRetrieves all campaigns associated with a given ad account.
Read-only operation, no modification of data.
get_adsets_by_adaccountRetrieves all ad sets associated with a given ad account.
Read-only operation, no modification of data.
get_ads_by_adaccountRetrieves all ads associated with a given ad account.
Read-only operation, no modification of data.
get_adsets_by_campaignRetrieves all ad sets associated with a given campaign.
Read-only operation, no modification of data.
get_ads_by_campaignRetrieves all ads associated with a given campaign.
Read-only operation, no modification of data.
get_ads_by_adsetRetrieves all ads associated with a given ad set.
Read-only operation, no modification of data.
get_ad_creatives_by_ad_idRetrieves all ad creatives associated with a given ad.
Read-only operation, no modification of data.
get_adaccount_insightsRetrieves performance insights for a specified ad account.
Read-only operation, no modification of data.
get_campaign_insightsRetrieves performance insights for a specified campaign.
Read-only operation, no modification of data.
get_adset_insightsRetrieves performance insights for a specified ad set.
Read-only operation, no modification of data.
get_ad_insightsRetrieves performance insights for a specified ad.
Read-only operation, no modification of data.
fetch_pagination_urlFetches data from a given pagination URL.
Read-only operation, retrieves data from a specified URL.
get_activities_by_adaccountRetrieves the change history for a specified ad account.
Read-only operation, no modification of data.
get_activities_by_adsetRetrieves the change history for a specified ad set.
Read-only operation, no modification of data.
Token
cloud
ads_readThis MCP server is relatively safe for read-only operations. However, the ability to modify ad campaigns introduces a moderate risk. Securely manage the Meta access token and monitor changes to ad campaigns to mitigate potential risks.
The server primarily supports read operations. Write operations are limited to modifying ad campaigns. Ensure proper authorization and monitoring when enabling write access.
Production Tip
Implement robust error handling and logging to monitor the server's performance and identify potential issues.
The Meta access token requires the `ads_read` permission for read-only access. Additional permissions may be required for write operations.
You need to generate a new Meta access token and update the configuration file of the MCP Client with the new token.
Yes, some tools allow for modifying ad campaigns, but exercise caution and monitor changes closely.
Consider implementing caching to improve performance for frequently accessed data and optimize API requests.
The server will return an error. Implement retry logic with exponential backoff to handle rate limiting.
While the token is stored locally, ensure your machine is secure and consider using environment variables or a secure configuration management system.
While the server provides tools for retrieving ad data, ad creation capabilities may be limited. Check the documentation for specific tools.