# Facebook Ads MCP > Facebook Ads MCP manages all your Meta advertising efforts through natural conversation. List campaigns, track performance metrics like impressions and spend, review targeting details for ad sets, and update statuses—all without logging into a dashboard. Connect your account to any AI client to take full control of campaign operations. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** social-media-ads, campaign-management, ad-performance, meta-marketing, ad-targeting, marketing-analytics ## Description Managing complex ad accounts used to mean juggling dashboards and copy-pasting data. Now, you can talk directly to your advertising backend through this MCP. Your agent handles the heavy lifting; you just ask questions. You can list all campaigns running or drill down into specific ads to check creative details and targeting parameters. Need an ROI report? The system extracts granular performance insights like total clicks, spend, and average CPC instantly. It even lets you update statuses—you tell it to pause a campaign, and it does it. Because this MCP is part of the Vinkius catalog, connecting your account means getting immediate access to dozens of other specialized tools, all from one connection point. You get full control over ad account metadata, ensuring you always know your spending limits and currency details. ## Tools ### get_ad_account_info Retrieves basic identifying information for the connected Facebook Ad Account. ### get_ad_details Fetches specific creative and targeting details about an individual ad unit. ### get_ad_set_details Provides detailed information, including budgets and targeting rules, for a specific ad set. ### get_campaign_details Retrieves comprehensive details about an entire advertising campaign structure. ### get_insights Calculates and provides performance metrics, such as total impressions, clicks, and average CPC, for the account. ### get_me Verifies which user token is currently authorized to make changes or read data. ### list_ad_sets Generates a list of all existing ad sets within the connected Ad Account. ### update_ad_status Changes the active status (on or off) for a specific ad unit. ### update_campaign_status Activates or pauses an entire campaign using its unique ID. ### list_campaigns Lists all the campaigns currently running in the Ad Account for review. ### update_ad_set_status Switches the status of an ad set, turning it on or off easily. ### list_ads Provides a list of every individual ad unit that belongs to the Ad Account. ## Prompt Examples **Prompt:** ``` List all active campaigns in my ad account. ``` **Response:** ``` Fetching active campaigns... You have 3 active campaigns: 'Spring Launch 2024' (ID: 123), 'Brand Awareness - Global' (ID: 456), and 'Retargeting - EU' (ID: 789). Would you like to see the daily spend for any of these? ``` **Prompt:** ``` Show me the performance insights for the last week. ``` **Response:** ``` Analyzing account insights... Over the last 7 days, your account generated 125,000 impressions and 2,400 clicks with a total spend of $1,250. Your average CPC is $0.52. ``` **Prompt:** ``` Pause campaign 123456789. ``` **Response:** ``` Updating campaign status... Campaign 123456789 ('Spring Launch') has been successfully PAUSED. ``` ## Capabilities ### Analyze Performance Metrics Fetch detailed performance insights on clicks, impressions, spend, and CPC for the entire ad account. ### Manage Campaign Statuses List all campaigns running in your account and update their active or paused status with a single command. ### Inspect Ad Targeting Details Retrieve deep details about specific ad sets, including targeting settings, budgets, and creative elements. ### View Account Health Get core information about your ad account, like the current balance, currency type, and overall status. ## Use Cases ### The underperforming campaign needs an emergency pause. A marketer notices a high spend on Campaign ID 789, but the click-through rate is terrible. They tell their agent to `update_campaign_status` for that ID to PAUSED immediately, stopping the bleed without navigating any menus. ### Need a weekly performance report summary. A growth team needs to prove ROI. They ask the agent to run `get_insights`, which returns structured data detailing impressions and average CPC, ready for immediate inclusion in a presentation deck. ### Checking ad targeting before launching. A business owner wants confirmation that an ad set is correctly targeted. They ask to run `get_ad_set_details` to review the exact demographics and location settings one last time. ## Benefits - Stop copying metrics manually. Use `get_insights` to instantly pull performance data like impressions, clicks, and total spend for immediate ROI analysis. - Never miss a deadline pausing an ad. You can use `update_ad_status` or `update_campaign_status` to change the active status of any unit with simple instructions. - Get deep visibility into targeting. The MCP lets you run `get_ad_set_details` to review exactly who your ads are hitting and what budgets they have. ## How It Works The bottom line is you talk naturally to the system, and it performs the ad management action. 1. Subscribe to this MCP on Vinkius and enter your Facebook Ads Access Token along with your Ad Account ID. 2. Connect this MCP to any compatible AI client like Claude, Cursor, or Windsurf. 3. Ask your agent directly: 'What were my clicks last week?' or 'Pause campaign 123456789.' ## Frequently Asked Questions **How do I find out my total spending using Facebook Ads MCP?** Use the `get_insights` tool. This function pulls aggregate performance metrics for the entire ad account, giving you a clear picture of your spend and impressions over time. **Can I pause an ad campaign with Facebook Ads MCP?** Yes, use `update_campaign_status`. You simply tell your agent to change the status for a specific Campaign ID, and it handles the update instantly. **What is the difference between listing ads and listing ad sets using Facebook Ads MCP?** The difference is scope. `list_ad_sets` shows groups of ads with shared targeting rules. `list_ads` gives you a list of every single, unique creative unit that's running. **Does Facebook Ads MCP show my budget limits?** Yes. You can run `get_ad_set_details` to review the specific budgets and spending caps set for any given ad set within your account.