Facebook Ads Agent

Create, manage, and optimize Facebook/Meta Ads campaigns with full control over campaigns, ad sets, targeting, and creatives. Powered by AdAgent.

Security & Data Handling

• - MCP link is a credential: Your MCP Server URL (https://adagent.10xboost.org/api/mcp/fb-ads/{user_id}/mcp) contains your user ID for credential lookup. Treat it like a password — do not share it publicly.
• Token scope: The service uses your Facebook OAuth token to access your ad accounts. It can create/modify campaigns, ad sets, and ads, manage budgets, and read performance data.
• Token storage: Your Facebook tokens are encrypted with Fernet (AES-128-CBC + HMAC) and stored in MongoDB. They are never exposed in API responses.
• Token expiry: Facebook long-lived tokens expire after ~60 days. Use refresh_token to extend when needed.
• Multi-tenant isolation: Each request is scoped to your user credentials via ASGI middleware. You can only access your own ad accounts.
• No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
• Third-party service: This skill relies on AdAgent, an AI-powered ad management platform.

Prerequisites

1. 1. Sign up at adagent.10xboost.org with Google
2. Connect Facebook Ads — authorize AdAgent to access your Facebook Ad accounts
3. Get your MCP link: Copy your Facebook Ads MCP Server URL from the dashboard
4. Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Available Tools (22 tools)

Account & Token

Tool	Description
INLINECODE2	List all accessible ad accounts
INLINECODE3

Get account details (currency, timezone, status) |

| check_token_status | Check token validity and expiry | | refresh_token | Exchange short-lived token for long-lived token (60 days) |

Campaign Management

Tool	Description
INLINECODE6	List campaigns (filter by status)
INLINECODE7

Get campaign details |

| create_campaign | Create campaign (PAUSED by default) | | enable_campaign | Activate a campaign | | pause_campaign | Pause a campaign |

Ad Set Management

Tool	Description
INLINECODE11	List ad sets (filter by campaign/status)
INLINECODE12

Get ad set details with full targeting |

| create_ad_set | Create ad set with audience targeting | | enable_ad_set | Activate an ad set | | pause_ad_set | Pause an ad set |

Ad Management

Tool	Description
INLINECODE16	List ads (filter by ad set/status)
INLINECODE17

Create ad (upload image + creative + ad) |

| enable_ad | Activate an ad | | pause_ad | Pause an ad |

Performance & Insights

Tool	Description
INLINECODE20	Account-level performance data
INLINECODE21

Campaign daily performance |

| get_ad_set_insights | Ad set performance |

Targeting Research

Tool	Description
INLINECODE23	Search interest targeting (e.g. "baseball", "cooking")
INLINECODE24

Search geographic targeting (country, city, zip) |

| search_targeting_categories | Browse targeting categories (interests, behaviors, demographics) |

Compliance

Tool	Description
INLINECODE26	Check Taiwan ad regulation compliance

Workflow

Creating a Full Ad (3-Layer Structure)

Facebook Ads uses a 3-layer hierarchy: Campaign → Ad Set → Ad

Step 1: Create Campaign

CODEBLOCK0

Objectives: OUTCOME_AWARENESS, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_SALES, OUTCOME_TRAFFIC, INLINECODE32

Budget rule: Set budget at Campaign OR Ad Set level, not both.

Step 2: Research Targeting

CODEBLOCK1

Step 3: Create Ad Set (with targeting)

CODEBLOCK2

If Campaign has budget set, do NOT set daily_budget_usd on Ad Set.

Step 4: Create Ad

CODEBLOCK3

CTA types: LEARN_MORE, SHOP_NOW, SIGN_UP, DOWNLOAD, BOOK_TRAVEL, INLINECODE39

Step 5: Enable (Campaign is PAUSED by default)

CODEBLOCK4

Checking Performance

User Request	Tool
"How are my ads doing?"	INLINECODE40
"Campaign X performance"

get_campaign_insights | | "Ad set performance" | get_ad_set_insights | | "List all campaigns" | list_campaigns |

CODEBLOCK5

Present Results

• - Performance: Show metrics table (impressions, clicks, CTR, CPC, CPM, spend, reach, frequency)
• Campaign list: Show status, objective, budget, and delivery status
• Targeting: Show audience size estimates when researching interests

Targeting Tips

• - Use search_interests to find interest IDs before creating ad sets
• Use search_locations with location_type (country, city, zip, region) for geo-targeting
• INLINECODE47 items use OR within each element, AND between elements
• INLINECODE48 enables Meta's Advantage+ automatic audience (recommended for beginners)

Error Handling

Error	Solution
Token expired	Use refresh_token or reconnect at adagent.10xboost.org
Invalid account ID

Run list_ad_accounts to get valid IDs | | Budget conflict | Budget must be at Campaign OR Ad Set level, not both | | Missing Page ID | Some objectives require page_id — get it from account info | | Taiwan regulation | Run get_taiwan_regulation_status to check compliance | | Ad rejected | Check Facebook ad policies — image text ratio, prohibited content |

Documentation

Product website: adagent.10xboost.org