# Facebook Ads MCP for AI Agents AI Agent Connect > Facebook Ads MCP. Manage your Meta ad campaigns, track ROI metrics, and update ad statuses directly through your AI client. No more jumping between tabs to check spend or pause underperforming creative. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/ai-agent-connect - **Tags:** social-media-ads, campaign-management, ad-performance, meta-marketing, ad-targeting, marketing-analytics ## Description Connect your Facebook Ads account to your AI agent and take full control of your advertising campaigns through natural conversation. Instead of digging through the complex Ads Manager interface to find out why a campaign is stalling, you just ask your agent for the latest stats. It pulls the numbers for you, showing spend, reach, and CPC in real-time. If you need to make a change, you don't have to navigate nested menus; you just tell your agent to pause a specific ad set or update a campaign status. It handles the heavy lifting of interacting with the Meta system so you can stay focused on the strategy. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start managing your ad spend with simple commands. It is about getting the information you need to make decisions without the friction of manual data entry or constant tab switching. ## Tools ### get_ad_account_info Get basic details for your Facebook Ad Account. This helps you see your current balance and currency at a glance. ### get_ad_details Get specific details for a single ad. Use this to review targeting, budgets, and creative information. ### get_campaign_details Get the full configuration for a specific campaign. You can use this to check the settings of your top-level ads. ### update_campaign_status Toggle a campaign's status between active and paused. This helps you manage your high-level strategy quickly. ### update_ad_status Change an ad to active or paused status. Use this to stop underperforming ads immediately. ### get_ad_set_details Get the configuration for a specific ad set. It lets you see the exact settings and budget for your groups. ### get_insights Pull performance metrics like impressions, clicks, and spend. This is how you see your actual ROI in real-time. ### get_me Check the identity and permissions of your current marketing token. Use this to verify your access level. ### list_ad_sets Get a list of all ad sets in your account. This is useful for a quick overview of your active groups. ### list_campaigns Get a list of all campaigns in your account. This provides a clear view of your entire ad structure. ### update_ad_set_status Change the status of an ad set with one command. It lets you pause or start entire groups of ads at once. ### list_ads Get a list of all ads in your account. Use this to see every individual creative currently running. ## 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) * **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 ### Pause underperforming ads Stop a specific ad from running immediately to save your budget. ### Check real-time spend metrics Pull current spend, reach, and CPC to see how your ads are performing right now. ### List active campaigns Get a full list of every campaign currently running in your account. ### Fetch specific ad set details Look into the specific targeting and budget settings of an ad set. ### Get account balance and currency Check your account balance and currency to ensure your ads keep running. ### Verify your marketing token identity Confirm that your marketing token is authorized and has the right access levels. ## Use Cases ### Checking for budget bleed A marketer asks their agent to show spend vs clicks for the week. The agent uses `get_insights` to show which ads are underperforming. ### Emergency campaign pause A business owner tells their agent to stop the Spring sale. The agent uses `update_campaign_status` to pause it instantly. ### Quick balance check A growth lead asks for the account balance to check the remaining budget. The agent uses `get_ad_account_info` to pull the data. ### Auditing active groups A user wants to see what is currently running. The agent uses `list_ad_sets` to show all active ad groups. ## Benefits - Stop wasting money by using `update_ad_status` to pause ads the second they underperform. - Get instant clarity on your ROI by pulling data with `get_insights` instead of manual exports. - Keep your account organized by using `list_campaigns` to see everything running at once. - Verify your access levels quickly with `get_me` to ensure your token is working correctly. - Deep dive into targeting with `get_ad_set_details` to see exactly who is seeing your ads. ## How It Works The bottom line is you get a direct line to your Meta data without the UI overhead. 1. Subscribe to the Facebook Ads MCP on Vinkius. 2. Provide your Facebook Ads Access Token and Ad Account ID. 3. Ask your AI agent to pull campaign stats or change ad statuses. ## Frequently Asked Questions **Can the Facebook Ads MCP help me see my current ad spend?** Yes. It pulls real-time metrics like spend, reach, and clicks directly from your Meta account so you can see your ROI without opening the Ads Manager. **How do I use the Facebook Ads MCP to pause a campaign?** You can just tell your AI agent to pause a specific campaign by name or ID. It will use the Connector to update the status instantly. **Can I check my Meta account balance with the Facebook Ads MCP?** Yes. The Connector can retrieve your account's basic info, including your current balance and currency, through a simple chat command. **Does the Facebook Ads MCP work with Claude and Cursor?** It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **Can I get performance metrics for specific ad sets using the Facebook Ads MCP?** Yes. You can ask for the specific details or insights of any ad set to see how your different audience groups are performing. **Is it possible to see all my active ads at once with the Facebook Ads MCP?** Yes. Your agent can list all ads or all campaigns in your account, giving you a high-level overview of everything currently running. **How do I find my Facebook Ad Account ID?** You can find your Ad Account ID in the **Meta Ads Manager**. It's the numeric ID shown in the URL or account selector. Ensure you provide it without the 'act_' prefix. **Can I pause an underperforming campaign using this agent?** Yes! Use the `update_campaign_status` tool and set the status to `PAUSED`. You can also resume it later by setting it back to `ACTIVE`. **Which performance metrics are available in the insights?** The `get_insights` tool provides comprehensive data including impressions, clicks, total spend, reach, CPC (cost per click), CTR (click-through rate), and CPP (cost per purchase).