Meta Ads

Give your AI agent direct access to your Meta Ads data.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

  • List Ad Accounts: List all ad accounts the authenticated user has access to. Returns each account's name, numeric ID, platform type, business name, currency, and data_synced status. Use the ad_account
  • List Entities: List campaigns, ad sets, or ads in a Meta ad account with their names, IDs, and statuses.
  • Get Performance: Retrieve aggregated performance metrics (spend, revenue, ROAS, CPA, etc.) for campaigns, ad sets, or ads in a Meta ad account over a date range.

What data it sees

Do you need an account

An API key from the service settings is required

Give your AI agent direct access to your Meta Ads data. Connect Claude, ChatGPT, or any MCP-compatible AI to your ad accounts and turn conversations into insights.

What you can do

  • Run full account audits — Ask your AI to analyze every campaign, flag wasted spend, and surface opportunities you're missing.
  • Keep your agency honest — You're paying thousands a month. Now you can have AI independently verify their work, check if budgets are allocated correctly, and spot underperforming campaigns they haven't addressed.
  • Strategize smarter — Plan new campaigns grounded in real performance data. Ask "what's working?" and get answers backed by actual ROAS, CPA, and spend numbers.
  • Cross-reference with other data sources — Already connected to Shopify, GA4, or your CRM? Combine your revenue data with ad performance to get the full picture: true customer acquisition costs, real ROAS by product line, and where your next dollar should go.

What's included

5 tools covering the full Meta Ads hierarchy:

Tool What it does
list_ad_accounts Discover all connected ad accounts
list_entities Browse campaigns, ad sets, and ads
get_performance Aggregated KPIs — spend, revenue, ROAS, CPA, and more
get_timeseries Daily metrics to spot trends and diagnose drops
get_entity_details Targeting, bid strategy, budgets, and creative config

Plus a business context resource with your break-even ROAS, AOV, target CPL, and an AI-generated research report for each account.

Getting started

  1. Sign up at adadvisor.ai and connect your Meta ad account
  2. Generate an API key in Settings
  3. Connect this MCP server using your key

Data syncs every 30 minutes. All tools are read-only. Your ad account is never modified!

How to connect

How to connect Meta Ads to Claude

The server address to paste into Claude settings:

https://meta-ads--adadvisor.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Meta Ads to ChatGPT

The server address to paste into ChatGPT settings:

https://meta-ads--adadvisor.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Meta Ads to Cursor

The server address to paste into Cursor settings:

https://meta-ads--adadvisor.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (5)

Raw names from tools/list. Only developers need these.

list_ad_accountsList all ad accounts the authenticated user has access to. Returns each account's name, numeric ID, platform type, business name, currency, and data_synced status. Use the ad_account_id from the results when calling other tools.
list_entitiesList campaigns, ad sets, or ads in a Meta ad account with their names, IDs, and statuses.
get_performanceRetrieve aggregated performance metrics (spend, revenue, ROAS, CPA, etc.) for campaigns, ad sets, or ads in a Meta ad account over a date range.
get_timeseriesGet daily time-series metrics for a single campaign, ad set, or ad. Returns one row per day with spend, revenue, ROAS, and efficiency KPIs.
get_entity_detailsGet configuration and settings for a single campaign, ad set, or ad. Returns objective, bid strategy, budget, targeting, and creative info.