# Snapchat Ads MCP

> Snapchat Ads MCP manages every part of your advertising ecosystem. Get detailed account listings, campaign performance metrics, ad squad data, and media assets—all via conversational AI. Audit complex campaigns, track spending, and pull reports across organizations without ever logging into a dashboard.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** ad-campaigns, performance-tracking, social-media-marketing, ad-spend, analytics-reporting

## Description

Managing large-scale ads means jumping between dozens of tabs and copying numbers into spreadsheets. This MCP changes that process entirely. You connect it to your agent, and instead of clicking through dashboards, you simply ask for what you need. Your agent handles the complex calls, compiling data from every layer: the organization level down to individual ad creatives.

Your AI client can instantly list all associated ad accounts, check the performance stats for a specific campaign, or audit your entire media library just by asking a question. Need to know how much was spent last month? Ask for detailed analytics; need to see every active creative asset? It pulls that data right up. This makes it feel like having a dedicated, real-time ad specialist available 24/7. By connecting this MCP through the Vinkius catalog, you get immediate access to all these advertising tools, making complex campaign management simple and conversational.

## Tools

### get_ad_account
Retrieves specific details about a single, given ad account.

### list_organizations
Lists all the Snapchat organizations that are linked to your advertising profile.

### get_ad_account_stats
Gathers detailed performance statistics for a specific ad account over time.

### get_campaign_stats
Retrieves specific, in-depth metrics and stats for one particular campaign.

### list_ad_accounts
Lists all ad accounts available under your connected Snapchat profile.

### list_ad_squads
Shows every group of ads (ad squad) associated with a given campaign.

### list_ads
Lists all the individual ad creatives that belong to an ad squad.

### list_campaigns
Shows all campaigns that are running under a specific ad account.

### list_media
Retrieves a list of all creative media assets available in an ad account.

## Prompt Examples

**Prompt:** 
```
List all my Snapchat organizations.
```

**Response:** 
```
I've retrieved your organizations. You have 2: 'Vinkius Global' and 'Media Team'. Which one would you like to audit for ad accounts?
```

**Prompt:** 
```
Show me active campaigns for ad account ID xxxx.
```

**Response:** 
```
I've found 3 active campaigns in that account: 'Spring Promo', 'App Install Drive', and 'Brand Reveal'. I can provide performance summaries for any of them.
```

**Prompt:** 
```
Get an ads report for last month.
```

**Response:** 
```
I've generated the report. Your total spend was $1,500 with 50,000 swipe-ups and an average cost per swipe of $0.03. Would you like a breakdown by campaign?
```

## Capabilities

### Map Organizational Structure
Lists all Snapchat organizations associated with your ad accounts so you know exactly where your efforts are running.

### Audit Ad Accounts and Stats
Retrieves specific details, metadata, and performance statistics for any single ad account.

### Trace Campaign Hierarchy
Navigates the full advertising structure by listing campaigns within an account, then detailing the ad squads and individual ads under those campaigns.

### Generate Performance Reports
Pulls detailed statistics for both accounts and specific campaigns, allowing you to analyze ROI over flexible date ranges.

### Inventory Creative Assets
Lists all media assets (creatives) associated with an account so you can verify your creative pipeline is healthy.

## Use Cases

### Running a Quarterly Audit
The analyst needs to prepare Q3 reports. They ask the agent to run list_ad_accounts first, then pull get_ad_account_stats for each one, and finally use get_campaign_stats on all active campaigns to build a single, data-backed presentation.

### Pre-Launch Creative Check
A marketing lead needs assurance that all new ads are ready. They prompt the agent to list_media for an account and then use list_ads to confirm the correct creatives were assigned to a specific ad squad.

### Pinpointing Budget Drain
The media buyer notices costs are spiking unexpectedly. They ask the agent to compare get_ad_account_stats with campaign-specific data from get_campaign_stats to pinpoint exactly which campaign is overspending.

### Mapping Out a New Initiative
A manager wants to understand the full scope of ads running. They start by calling list_organizations, then proceed down the chain: list_ad_accounts, followed by list_campaigns and list_ad_squads.

## Benefits

- Eliminate dashboard hopping. Instead of logging into multiple places to check metrics, ask the agent to get_ad_account_stats and pull all necessary performance data in one conversation.
- Maintain creative governance effortlessly. Use list_media to instantly see every single asset you have on file for an ad account, ensuring nothing falls through the cracks.
- Track spending across your entire structure. Start by listing organizations, then drill down using list_ad_accounts and list_campaigns to map out exactly where money is going.
- Get precise performance data when you need it. Rather than relying on vague reports, use get_campaign_stats to pull exact metrics for a single campaign over custom date ranges.
- Simplify complex reporting. The agent can navigate the full hierarchy—from ad accounts down through list_ad_squads and list_ads—to give you one comprehensive overview.

## How It Works

The bottom line is that you talk to your agent like you're talking to a coworker who already has access to every single dashboard you need.

1. Subscribe to this MCP and enter your Snapchat Ads Access Token through Vinkius.
2. Use any MCP-compatible client, like Cursor or Claude, to prompt your agent with a request (e.g., 'Show me the stats for Campaign X').
3. The agent executes the necessary tool calls, compiling structured data on accounts, campaigns, and performance metrics directly into the chat.

## Frequently Asked Questions

**How do I see all my ad accounts using Snapchat Ads MCP?**
You start by invoking list_ad_accounts. This tool provides a master roster of every single ad account linked to your profile, letting you decide where to focus your audit next.

**Can I get the stats for one campaign using Snapchat Ads MCP?**
Yes, use get_campaign_stats. You just need to provide the correct Campaign ID, and the tool pulls detailed performance metrics for that specific effort.

**How can I audit all my ad creatives? Is there a tool for that?**
Absolutely. Use list_media. This dedicated tool bypasses campaign structures and gives you a comprehensive inventory of every single media asset (images, videos) in your account.

**Do I need to know the organization ID first? Which tool helps with that?**
You can start by calling list_organizations. This tool lists all associated organizations, helping you scope out which corporate entity holds the ad accounts you want to audit.

**What if I need performance data for multiple accounts? Is there a way?**
You can use list_ad_accounts first to get all IDs. Then, prompt your agent to run get_ad_account_stats across the entire generated list of account IDs.