The agent-native Meta advertising manager
Connect any AI agent to manage Meta advertising campaigns, ad sets, creatives, and performance reporting through the Meta Graph API — create campaigns, upload media, launch ads, and export reports — all through the Model Context Protocol.
How it works
From sign-up to running Meta ads in seven steps.
Sign up and get an API key
Create a free account at gentic.co, generate an API key from your dashboard, and use it as a Bearer token to authenticate your agent.
Connect your agent
Add the MCP server URL to Claude Code, Claude Web, OpenClaw, Claude Cowork, ChatGPT, n8n, or any MCP-compatible client. Pass your API key as a Bearer token.
Browse your ad accounts
Let your agent navigate your Meta ad account hierarchy — accounts, campaigns, ad sets, ads, and creatives — to understand your current setup.
Fetch performance insights
Pull ad performance metrics with date filtering and breakdowns. Analyze spend, impressions, clicks, conversions, and more across any level of the hierarchy.
Create campaigns and ad sets
Launch new campaigns with objectives and budgets, then create ad sets with targeting, scheduling, and bid strategies — all defaulting to PAUSED for safe review.
Upload media and create ads
Upload video and image assets, then create ads that combine your media with copy, CTAs, and landing page URLs. Advantage+ creative enhancements are automatically disabled for full control.
Export reports
Generate CSV performance reports via the Meta Async Report API. Download links are valid for 1 hour — perfect for recurring analysis workflows.
Available tools
Eleven tools your AI agent can call through the Model Context Protocol.
get_meta_ids
Browse your Meta ad account hierarchy — accounts, campaigns, ad sets, ads, and creatives. Navigate the full tree to find and reference any object by ID.
- -5 hierarchy levels (account to creative)
- -Paginated results
- -Returns IDs, names, and statuses
fetch_meta_insights
Get ad performance metrics with date presets and breakdowns. Pull spend, impressions, clicks, conversions, ROAS, and more at any level of the hierarchy.
- -Date presets (today, last_7d, lifetime, etc.)
- -Breakdowns (age, gender, country, device)
- -Account, campaign, ad set, or ad level
- -All standard Meta metrics
fetch_meta_ad_creatives
Get creative details for any ad — copy, images, videos, thumbnails, CTAs, and landing page URLs. Inspect what assets are running across your campaigns.
- -Image and video URLs
- -Ad copy and headlines
- -CTA types and link URLs
- -Thumbnail URLs for video ads
get_meta_pages
List Facebook Pages for the authenticated user. Required for ad creation — every ad must be associated with a Page.
- -Returns Page IDs and names
- -Lists all accessible Pages
- -Required for ad creation workflow
create_meta_campaign
Create new Meta ad campaigns with objectives, budgets, and bid strategies. Campaigns default to PAUSED status for safe review before going live.
- -Defaults to PAUSED status
- -OUTCOME_SALES default objective
- -Campaign budget optimization (CBO)
- -Special ad categories support
create_meta_adset
Create ad sets with targeting, budgets, scheduling, and bid strategies. Define your audience, placement, and delivery optimization.
- -Age, gender, and geo targeting
- -Interest and behavior targeting
- -Daily or lifetime budgets
- -Start and end date scheduling
upload_meta_video
Upload video files to your Meta ad account for use in video ads. Provide a URL to the video file and receive a video asset ID.
- -Upload from URL
- -Returns video asset ID
- -Ready for ad creation
upload_meta_image
Upload image files to your Meta ad account for use in static image ads. Provide a URL to the image file and receive an image hash.
- -Upload from URL
- -Returns image hash
- -Ready for image ad creation
create_meta_ad
Create video ads with copy, CTAs, and landing page URLs. Advantage+ creative enhancements are automatically disabled for full creative control.
- -Video ad creation
- -Custom copy and headlines
- -CTA and landing page URL
- -Advantage+ auto-disabled
create_meta_image_ad
Create static image ads with copy, CTAs, and landing page URLs. Advantage+ creative enhancements are automatically disabled for full creative control.
- -Static image ad creation
- -Custom copy and headlines
- -CTA and landing page URL
- -Advantage+ auto-disabled
export_meta_report
Export performance data as CSV via the Meta Async Report API. Download links are valid for 1 hour — ideal for recurring analysis and reporting workflows.
- -CSV download link
- -Customizable columns and breakdowns
- -Date range filtering
- -Link valid for 1 hour
Connect in seconds
Sign up, grab your API key, and add the server to your agent. Manage campaigns, pull insights, create ads, and export reports. Works with Claude Code, Claude Web, OpenClaw, Claude Cowork, ChatGPT, n8n, and any MCP client.
claude mcp add gentic-meta \
--transport http \
https://mcp.gentic.co/meta \
--header "Authorization: Bearer YOUR_API_KEY"You can also connect via OAuth — just add Gentic Meta Ads as a connector in Claude or ChatGPT settings. No API key needed; authentication is handled automatically.
Install the Gentic agent skill to teach your agent the optimal workflow — browsing ad accounts, pulling insights, creating campaigns and ad sets, uploading media, and launching ads — so it gets the best results automatically.
npx skills add gentic-co/agent-skillsWorks with Claude Code, Cursor, Copilot, and 40+ other agents.
Pay per use
No subscriptions. No seat licenses. You only pay when your agent calls a paid tool.
| Action | Cost |
|---|---|
| get_meta_ids | Free |
| fetch_meta_insights | $0.10 per call |
| fetch_meta_ad_creatives | $0.05 per call |
| get_meta_pages | Free |
| create_meta_campaign | Free |
| create_meta_adset | Free |
| upload_meta_video | Free |
| upload_meta_image | Free |
| create_meta_ad | $1.00 per call |
| create_meta_image_ad | $1.00 per call |
| export_meta_report | $1.00 per call |
Example
Browse ad accounts, fetch insights for 3 campaigns, create 1 campaign + 1 ad set, upload 1 image, create 1 image ad, and export a report = Free + (3 x $0.10) + Free + Free + Free + $1.00 + $1.00 = $2.30
Why agent-native?
Traditional ad management tools weren't built for AI. This one was.
No UI to learn
Your AI agent is the interface. Describe what you want to do with your Meta ads in natural language — no Ads Manager dashboards, no learning curve.
Composable workflows
Chain campaign creation with insights analysis, creative uploads, and report exports. Build end-to-end advertising pipelines your way.
Portable
Works with any MCP-compatible client — Claude Web, Claude Code, OpenClaw, ChatGPT, n8n, and more. Switch clients without changing a thing.
Pay per use
No monthly seats or platform fees. You pay only when your agent calls a paid tool. Free tools stay free forever.