# AdWeave Meta Ads

Meta Ads MCP server with 47 tools for campaigns, creatives, audiences, and insights — plus AI-powered campaign diagnosis and buyer personas.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add brandon-vyur/adweave

# Browse available tools
npx -y @smithery/cli@latest tool list brandon-vyur/adweave

# Get full schema for a tool
npx -y @smithery/cli@latest tool get brandon-vyur/adweave tool_get_ad_accounts

# Call a tool
npx -y @smithery/cli@latest tool call brandon-vyur/adweave tool_get_ad_accounts '{}'
```

## Direct MCP Connection

Endpoint: `https://adweave.run.tools`

## Tools (50)

- `tool_get_ad_accounts` — Get ad accounts accessible by the current user.
- `tool_get_account_info` — Get detailed information about a specific ad account.
- `tool_get_account_pages` — Get Facebook Pages associated with a Meta Ads account.
- `tool_get_campaigns` — Get campaigns for a Meta Ads account with optional filtering.
- `tool_get_campaign_details` — Get detailed information about a specific campaign.
- `tool_create_campaign` — Create a new campaign in a Meta Ads account.
- `tool_update_campaign` — Update an existing campaign.
- `tool_duplicate_campaign` — Duplicate a campaign with all its settings.
- `tool_get_adsets` — Get ad sets for a Meta Ads account, optionally filtered by campaign.
- `tool_get_adset_details` — Get detailed information about a specific ad set.
- `tool_create_adset` — Create a new ad set in a Meta Ads account.
- `tool_update_adset` — Update an ad set with new settings.
- `tool_duplicate_adset` — Duplicate an ad set with its settings.
- `tool_get_ads` — Get ads for a Meta Ads account with optional filtering.
- `tool_get_ad_details` — Get detailed information about a specific ad.
- `tool_create_ad` — Create a new ad with an existing creative.
- `tool_update_ad` — Update an ad with new settings.
- `tool_duplicate_ad` — Duplicate an ad, optionally changing the destination URL.
- `tool_get_ad_creatives` — Get creative details for a specific ad. Requires an ad_id.
- `tool_get_creative_details` — Get detailed information about a specific ad creative by its ID.
- `tool_create_ad_creative` — Create a new ad creative using an uploaded image hash or video ID.
- `tool_update_ad_creative` — Update an existing ad creative's name or optimization settings.
- `tool_duplicate_creative` — Duplicate a creative, optionally overriding content fields.
- `tool_create_carousel_ad_creative` — Create a carousel ad creative with 2-10 cards.
- `tool_get_insights` — Get performance insights for a campaign, ad set, ad, or account.
- `tool_bulk_get_insights` — Fetch performance insights for multiple ad accounts in parallel.
- `tool_search_interests` — Search for interest targeting options by keyword.
- `tool_search_geo_locations` — Search for geographic targeting locations.
- `tool_search_demographics` — Get demographic targeting options.
- `tool_search_behaviors` — Get all available behavior targeting options.
- `tool_get_interest_suggestions` — Get interest suggestions based on existing interests.
- `tool_estimate_audience_size` — Estimate audience size for targeting specifications.
- `tool_upload_ad_image` — Upload an image to use in Meta Ads creatives. Returns an image_hash.
- `tool_upload_ad_video` — Upload a video to a Meta Ads account.
- `tool_get_ad_image` — Get the image URL for a specific ad.
- `tool_bulk_upload_ad_images` — Upload multiple images to Meta Ads accounts.
- `tool_bulk_upload_ad_videos` — Upload multiple videos to Meta Ads accounts.
- `tool_bulk_update_campaigns` — Update multiple campaigns with individual or uniform parameters.
- `tool_bulk_update_adsets` — Update multiple ad sets with individual or uniform parameters.
- `tool_bulk_update_ads` — Update multiple ads with individual or uniform parameters.
- `tool_search` — Search through Meta Ads data and return matching records.
- `tool_fetch` — Fetch complete record data by ID.
- `tool_search_pages_by_name` — Search for pages by name within an account.
- `tool_get_instagram_accounts` — Get Instagram business accounts associated with an ad account.
- `tool_create_budget_schedule` — Create a budget schedule for a campaign.
- `tool_create_email_report` — Create an email report for ad performance.
- `tool_get_partnership_accounts` — List all creators with partnership ad access for a brand IG account.
- `tool_get_creator_media` — Fetch posts/reels from a creator's Instagram account.
- `tool_get_creator_media_insights` — Get engagement stats for a specific creator post.
- `tool_create_ad_from_partnership_code` — Create a partnership ad from a creator's ad code string (e.g. adcode-Q9jTBB...).

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get brandon-vyur/adweave <tool-name>
```