# Meta Ads

**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.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add adadvisor/meta-ads

# Browse available tools
npx -y smithery tool list adadvisor/meta-ads

# Get full schema for a tool
npx -y smithery tool get adadvisor/meta-ads list_ad_accounts

# Call a tool
npx -y smithery tool call adadvisor/meta-ads list_ad_accounts '{}'
```

## Direct MCP Connection

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

**Required config:**
- `x-api-key` (header) — Your AdAdvisor API key (starts with adv_sk_). Get one at https://adadvisor.ai?utm_source=smithery&utm_medium=mcp&utm_campaign=tk-smithery

## Tools (5)

- `list_ad_accounts` — List all ad accounts the authenticated user has access to. Returns each account's name, numeric ID, platform type, busi…
- `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 a…
- `get_timeseries` — Get daily time-series metrics for a single campaign, ad set, or ad. Returns one row per day with spend, revenue, ROAS, …
- `get_entity_details` — Get configuration and settings for a single campaign, ad set, or ad. Returns objective, bid strategy, budget, targeting…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get adadvisor/meta-ads <tool-name>
```

## Prompts (2)

- `analyze_account` (account_id) — Step-by-step workflow for analyzing a Meta ad account. Walks through account discovery, business context, and performan…
- `diagnose_performance` (account_id, entity_type, entity_id) — Guided diagnosis for a campaign, ad set, or ad that has seen a performance decline. Identifies when the drop started an…