Meta Ads

Manage Facebook and Instagram advertising campaigns, analyze performance metrics, create audiences, and control ad creatives

Overview

The Meta Ads server enables AI assistants to manage advertising campaigns across Facebook and Instagram through the Meta Marketing API. It provides comprehensive ad management capabilities including campaign creation, audience targeting, creative management, and performance analytics. Built by wipsoft.

How to Add Meta Ads

1. Add Server

   Add the Meta Ads server to your Nexus environment through the server directory.

2. Authorize

   Connect your Meta account using Facebook Login and approve the OAuth consent request to grant access to your ad accounts.

3. Test Connection

   Try “Verify my Meta ad account setup” or “List my active campaigns” to verify the connection works.

Facebook Login for Business: Meta Ads uses Facebook OAuth for authentication. You’ll need a Meta Business account with access to an ad account.

Experimental Status: This server is marked as EXPERIMENTAL and uses the Meta Marketing API v23.0.

What You Can Do

Campaign Management

Create, update, pause, resume, and delete ad campaigns with full budget and objective control

Analytics & Insights

Analyze performance metrics, compare campaigns, track attribution, and export reports

Audience Targeting

Build custom audiences, create lookalikes, estimate reach, and manage targeting

Creative Management

Create ad creatives, upload assets, preview ads, validate compliance, and A/B test

Available Tools (49)

Campaign Management (8)

list_campaigns

Retrieve a paginated list of all campaigns for a Meta ad account. Filter by status (ACTIVE, PAUSED, DELETED, ARCHIVED) and view key campaign details including budget, objective, and timing.

create_campaign

Create a new Meta ad campaign with a specified objective, name, and budget. Supports daily or lifetime budgets, scheduling, special ad categories, and bid strategies. Campaigns are created in PAUSED status by default.

update_campaign

Update an existing campaign’s settings including name, status, budget, or schedule. Only provided fields are updated.

get_campaign

Retrieve full details for a specific campaign by ID including status, objective, budget, and timing.

pause_campaign

Instantly pause a campaign to stop ad delivery and spending. Use for emergency stops, budget control, or temporary suspensions.

resume_campaign

Reactivate a previously paused campaign to resume ad delivery and spending.

delete_campaign

Permanently delete a campaign and all its associated ad sets and ads. This action cannot be undone.

check_campaign_readiness

Check if a campaign is ready for ad set creation. Returns a readiness report with issues, requirements, and recommendations. Use before creating ad sets to avoid common errors.

Ad Set Management (3)

list_ad_sets

List all ad sets for a given campaign or ad account. Filter by status and paginate results. Returns details including budget, targeting, and optimization settings.

create_ad_set_enhanced

Create a new ad set with advanced validation and helpful error messages. Specify campaign, name, budget, optimization goal, billing event, targeting, and promoted object. Returns the new ad set ID or detailed error guidance.

list_campaign_ad_sets

List all ad sets within a specific campaign with a summary of active/paused counts and total daily budget.

Ad Management (1)

list_ads

List all ads for a given campaign, ad set, or ad account. Filter by status and paginate results. Returns ad details including creative, status, and timing.

Analytics & Insights (5)

get_insights

Retrieve performance metrics for campaigns, ad sets, or individual ads. Supports customizable date ranges, metric selection, and data breakdowns by dimensions like age, gender, and placement.

get_campaign_performance

Get performance insights specific to a campaign with campaign-specific defaults. Simplified version of get_insights.

compare_performance

Compare performance metrics across multiple campaigns, ad sets, or ads (2-10 items) to identify top performers and optimization opportunities.

get_attribution_data

Get attribution data for campaigns including conversion tracking and attribution windows.

export_insights

Export ad insights data in CSV or JSON format for external analysis, reporting, and data warehousing.

Audience Management (7)

list_audiences

List all custom audiences in the ad account. Filter by type (custom, lookalike, saved).

create_custom_audience

Create a custom audience from customer data, website traffic, or app activity. Supports multiple subtypes including WEBSITE, APP, and OFFLINE_CONVERSION.

create_lookalike_audience

Create a lookalike audience based on an existing custom audience to reach new potential customers. Configure country and audience ratio (1%-20% of population).

estimate_audience_size

Estimate the size of an audience based on targeting parameters including demographics, interests, behaviors, and custom audiences.

update_custom_audience

Update custom audience settings and configuration.

delete_audience

Get guidance on audience deletion process. Deleting an audience is permanent and cannot be undone.

get_audience_insights

Get guidance on retrieving audience demographic insights including age distribution, gender, location, and interest affinity.

Creative Management (16)

list_creatives

List all ad creatives in an ad account to see existing creatives, their formats, and content.

create_ad_creative

Create a new ad creative with images, videos, text, and call-to-action buttons. Supports both image and video creatives with Meta API v23.0 compliance.

validate_creative_setup

Validate ad creative parameters before creation to catch errors early. Checks required fields and URL validity.

validate_creative_enhanced

Enhanced creative validation with comprehensive checks including page permissions, image accessibility, and Meta API compliance.

preview_ad

Generate HTML preview of how an ad creative will appear in different placements (desktop feed, mobile feed, Instagram, Stories).

upload_image_from_url

Upload an image from a URL to Meta and get the image_hash for v23.0 API compliance.

upload_creative_asset

Get guidance on uploading creative assets (images/videos) to Meta with step-by-step instructions and technical requirements.

setup_ab_test

Get comprehensive guidance on setting up A/B tests for ad creatives including best practices and metrics to track.

get_creative_performance

Get guidance on analyzing creative performance metrics and optimization strategies.

update_creative

Get information about creative update limitations - creatives cannot be modified after creation, provides alternative approaches.

delete_creative

Get guidance on creative deletion process and impact, with safety checks to avoid disrupting active campaigns.

get_creative_best_practices

Get comprehensive best practices for creating high-performing ad creatives with platform-specific guidelines.

troubleshoot_creative_issues

Diagnose and fix common creative creation and performance issues with specific solutions and recommendations.

analyze_account_creatives

Analyze all creatives in an account to identify patterns, performance insights, and optimization opportunities.

check_api_v23_compliance

Check if creative parameters are compliant with Meta Marketing API v23.0 requirements and get recommendations.

get_meta_error_codes

Get detailed reference for Meta Marketing API error codes, subcodes, and specific solutions for troubleshooting.

Helper & Reference (3)

get_meta_api_reference

Get a reference guide for valid Meta Marketing API parameters including allowed optimization goals, billing events, and their valid combinations.

get_quick_fixes

Get targeted troubleshooting tips for common Meta Ads API errors with likely causes and next steps.

verify_account_setup

Verify that a Meta ad account is ready for ad creation. Checks account access, payment method, Facebook pages, and active campaigns.

OAuth & Authentication (6)

generate_auth_url

Generate OAuth authorization URL for Meta to redirect users for authentication.

exchange_code_for_token

Exchange OAuth authorization code for an access token.

refresh_to_long_lived_token

Exchange a short-lived token for a long-lived token (~60 days).

generate_system_user_token

Generate a system user token for server-to-server automation.

get_token_info

Get information about the current access token including expiration time, scopes, and associated user.

validate_token

Validate the current access token and check API connectivity.

Use Cases

Campaign Launch

“Create a new traffic campaign called ‘Spring Sale 2025’ with a $50 daily budget” - Set up a new advertising campaign with objective and budget.

Performance Review

“Show me the performance of my active campaigns for the last 30 days” - Analyze campaign metrics with custom date ranges.

A/B Testing

“Compare performance between campaigns 123 and 456 on click-through rate and cost per click” - Compare metrics across campaigns to find top performers.

Audience Building

“Create a lookalike audience based on my top customers targeting the US at 1%” - Build lookalike audiences to reach new potential customers.

Creative Setup

“Create an ad creative with my product image, ‘Shop Now’ CTA, and link to my store” - Build ad creatives with images, text, and call-to-action buttons.

Budget Control

“Pause all my active campaigns immediately” - Emergency stop ad delivery across campaigns.

Reporting

“Export last month’s campaign insights as CSV” - Export performance data for external analysis.

Account Health

“Verify my ad account is set up correctly for creating ads” - Check account readiness including payment methods and page access.

Budget Format: All budget values are specified in account currency cents (e.g., $50.00 = 5000).

Campaign Objectives: Uses Meta’s Outcome-Driven Ad Experience (ODAE) format: OUTCOME_APP_PROMOTION, OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC.

Creative Limitations: Ad creatives cannot be modified after creation. To make changes, create a new creative and update the ad to use it.

API Version: This server uses Meta Marketing API v23.0. Use check_api_v23_compliance to verify your parameters are compliant.

Troubleshooting

Permission Issues After Connecting

Meta’s OAuth flow sometimes does not prompt for ads permissions during authorization. If you’ve connected successfully but still receive permission errors, you’ll need to grant ad account access manually.

This is a known issue with Meta’s OAuth — the ad account must explicitly grant your user account the proper permissions, which can’t always be done through the OAuth flow alone.

Option 1: Grant permissions via Business Manager (Recommended)

1. Go to Meta Business Settings
2. Navigate to Users > People in the left sidebar
3. Find yourself in the list and click your name
4. Click Assign Assets
5. Select the Ad Accounts tab
6. Find your ad account and select it
7. Make sure you have Manage campaigns or Full control permission selected

Option 2: Direct Ad Account Access

1. Go to Meta Ads Manager
2. In the account selector, find your ad account
3. Click the account settings
4. Go to Ad Account Roles
5. Make sure your account has Admin or Advertiser role

After making these changes in Business Manager, the permissions should propagate and you can reconnect the server.