Welcome to Facebook Ads MCP

This interface provides examples and explanations for using the Facebook Ads MCP (Model Context Protocol) tools with Claude. The Facebook Ads MCP allows Claude to access and analyze your Facebook Ads data, providing insights and recommendations to help optimize your advertising campaigns.

Make sure the cloud-run-proxy.js script is running before using these tools. You can start it by double-clicking the start-facebook-ads-mcp.bat file.

Available Tools

Interactive Dashboard

A web-based dashboard for visualizing and analyzing your Facebook Ads data with Claude's assistance.

Open Dashboard
Demo Guide

A step-by-step guide to test your Facebook Ads MCP with Claude and use the interactive dashboard.

View Guide
Token Updater

A utility to update your Facebook access token when it expires (approximately every 60 days).

Update Token

Example Commands for Claude

Basic Account Information
Can you list all my Facebook ad accounts and tell me which ones are active?
This command asks Claude to retrieve a list of all your Facebook ad accounts and their status. 
What's the total spend across all my ad accounts this month?
This command asks Claude to calculate the total spend across all your Facebook ad accounts for the current month.
Campaign Analysis
Show me my top performing campaigns by ROAS for the last 30 days.
This command asks Claude to analyze your campaigns and rank them by Return on Ad Spend (ROAS) for the last 30 days. 
Analyze the performance trend of my Summer Sale campaign over the past 3 months.
This command asks Claude to analyze the performance trend of a specific campaign over time.
Audience Insights
What demographics respond best to my ads? Break it down by age, gender, and location.
This command asks Claude to analyze which demographics have the highest engagement with your ads. 
Analyze my audience engagement by device type and time of day.
This command asks Claude to analyze how your audience engages with your ads based on device type and time of day.
Optimization Suggestions
How can I improve the performance of my Brand Awareness campaign? Provide specific recommendations.
This command asks Claude to provide specific recommendations to improve a campaign's performance. 
Suggest budget reallocations across my campaigns to maximize ROAS.
This command asks Claude to suggest how to reallocate your budget across campaigns to maximize return on ad spend.
Reporting
Create a weekly performance summary for my Facebook ads with key metrics and insights.
This command asks Claude to generate a weekly performance report for your Facebook ads. 
Generate a report comparing this month's performance to last month with visualizations.
This command asks Claude to create a comparative report between this month and last month.

Interactive Dashboard

The Facebook Ads Dashboard provides a user-friendly interface for viewing and analyzing your Facebook Ads data with Claude's assistance. It includes overview metrics, performance charts, campaign listings, and AI-powered insights from Claude.

Dashboard Preview
Dashboard Features
  • Dashboard Tab: Overview of your Facebook Ads performance with key metrics and Claude's insights
  • Campaigns Tab: List of your campaigns with performance data and analysis options
  • Ad Sets Tab: Details about your ad sets
  • Ads Tab: Information about individual ads
  • Insights Tab: Claude's analysis of your Facebook Ads data
  • Ask Claude Tab: Chat interface to ask Claude questions about your data
Open Dashboard

Help & Troubleshooting

Common Issues

  1. Make sure the cloud-run-proxy.js script is running. You can start it by double-clicking the start-facebook-ads-mcp.bat file.
  2. Check that your Facebook access token is valid. Facebook tokens expire after about 60 days.
  3. If your token has expired, use the update-facebook-token.bat script to update it.
  4. Restart VSCode if you've recently set up the MCP.

  1. Make sure the cloud-run-proxy.js script is running.
  2. Check the browser console for any JavaScript errors (press F12 to open developer tools).
  3. Make sure you're using a modern browser (Chrome, Firefox, Edge).
  4. Try refreshing the page.
  5. Check that your Facebook access token is valid.

  1. Generate a new token from Facebook Graph API Explorer.
  2. Double-click the update-facebook-token.bat file.
  3. Paste your new token when prompted.
  4. Choose whether to redeploy to Google Cloud Run immediately or later.
Additional Resources
If you continue to experience issues, please check the logs in the cloud-run-proxy.js terminal window for more information.