# Snapchat Conversions MCP

> Snapchat Conversions MCP Server sends conversion events directly to Snapchat Ads via the Conversions API. This lets your AI agent track purchases, page views, and sign-ups server-side, bypassing cookie limitations for accurate marketing attribution.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** conversion-tracking, ad-attribution, event-reporting, marketing-api, data-sync

## Description

You know how cookies are dying? This server fixes that. It connects your backend straight to Snapchat Ads via the Conversions API (CAPI). You're sending conversion data directly from your agent, which lets you track everything—purchases, page views, sign-ups—server-side. That means accurate ad attribution even when browser tracking fails.

**Setting Up and Verifying Data Flow**

Before you send anything, you gotta make sure the connection is clean. Use `check_capi_health` to report on your API connection status right now. You can also pull up best practices documentation using `get_capi_integration_guidelines`; that shows you exactly how you must hash user data for compliance before sending it out. If you need to know what Snapchat accepts, run `list_supported_conversion_events` to get every valid event type the API will take.

**Mapping the Customer Journey**

This tool suite lets your agent track specific steps a customer takes on your site. When a user views content, `track_view_content_event` logs that product or page view. If they search something, `track_search_event` records which query they typed in. You can log a basic visit with `track_page_view_event`, noting the URL visited. Next up, if they add an item to their cart, `track_add_to_cart_event` reports it. When they start checking out, `track_start_checkout_event` logs that action. Finally, when they successfully buy something, `track_purchase_event` tracks the completed sale, requiring specific user and transaction IDs for full attribution.

**Handling Specific Conversions and Users**

You can track multiple types of success actions. Use `track_sign_up_event` to record that a new account was created successfully. For mobile apps, you've got `track_app_open_event` for the initial launch. You also have the ability to send raw data using `send_custom_conversion_event`, letting your agent transmit any custom JSON payload for tracking needs that don't fit a dedicated tool endpoint.

**Managing User Identity**

The system manages user identifiers by accepting hashed customer metadata—like emails or phone numbers. This lets Snapchat match the users on your site to the data they have on the ad platform, making attribution much cleaner.

## Tools

### check_capi_health
Checks and reports on the current status of your Snapchat Conversions API connection.

### get_capi_integration_guidelines
Retrieves best practices documentation detailing how you must hash user data for compliance.

### list_supported_conversion_events
Returns a list of every valid event type that the Snapchat API accepts.

### track_add_to_cart_event
Reports that a user added a specific item to their shopping cart.

### track_app_open_event
Tracks the initial opening of your mobile application.

### track_page_view_event
Logs a basic website page view, recording which URL was visited.

### track_purchase_event
Tracks a successful purchase, requiring specific user and transaction identifiers.

### send_custom_conversion_event
Sends any raw, custom JSON conversion event payload you define for highly unique tracking needs.

### track_search_event
Logs when a user performs a search query on your website.

### track_sign_up_event
Records that a new user successfully registered an account.

### track_start_checkout_event
Logs the moment a user begins the checkout process with items in their cart.

### track_view_content_event
Records when a user views an individual product or content page.

## Prompt Examples

**Prompt:** 
```
Send a PURCHASE conversion event to Snapchat with pixel ID 'abc-123'.
```

**Response:** 
```
Conversion event triggered! I've successfully reported the purchase event to Snapchat via the Conversions API. Transaction ID: TXN-456.
```

**Prompt:** 
```
Show me the conversion funnel performance for all active Snapchat ad campaigns.
```

**Response:** 
```
4 active Snapchat campaigns. "Summer Collection" (swipe-up): 234K impressions, 12.4K swipes (5.3% CTR), 890 add-to-carts, 234 purchases. ROAS: 4.2x. Spend: $2,340. Revenue: $9,828. "App Install" (deep link): 156K impressions, 8.9K taps, 2,340 installs. CPI: $1.23. "Brand Awareness" (story ad): 890K impressions, 67K views (7.5% VTR). "Lead Gen" (form): 45K impressions, 1,200 leads. CPL: $3.80. Total Snap Pixel events tracked: 45,678.
```

**Prompt:** 
```
Send a batch of purchase conversion events for orders processed through our checkout today.
```

**Response:** 
```
Conversion events batch sent to Snapchat Conversions API. Events: 67 PURCHASE events. Total revenue reported: $8,945. Average order value: $133.51. Deduplication: 4 events matched existing Snap Pixel events (removed). Net new: 63 events. Match rate: 89% (Snapchat matched 56 events to Snapchat users). Attribution window: 28-day click, 1-day view. Events timestamped with original transaction time. Next sync scheduled: 6 hours. Campaign optimization data will update within 4 hours.
```

## Capabilities

### Report Purchases
Sends a completed purchase record, including transaction IDs and revenue, directly to Snapchat Ads for attribution.

### Track Funnel Steps
Fires specific user actions—like viewing a product or starting checkout—to map the entire customer journey in real-time.

### Send Custom Events
Allows the agent to send raw, custom JSON payloads for unique conversion events that don't have a dedicated tool endpoint.

### Manage User Identifiers
Submits hashed customer metadata (emails, phone numbers) so Snapchat can match your on-site users to ad platform data.

### Check API Status
Verifies the connection and current health status between your system and the Snapchat Conversions API endpoint.

## Use Cases

### The abandoned cart sequence.
A user browses products, then leaves. Your agent detects the exit and immediately runs `track_add_to_cart_event` followed by `track_view_content_event`. This gives your marketing team a full picture of interest to use for retargeting ads.

### Tracking multi-step signups.
A user signs up via a form, but the process takes three steps. Your agent tracks the initial `track_sign_up_event` and then runs `track_start_checkout_event` once they hit payment. This connects all parts of the funnel.

### Batch reporting for accounting.
Instead of tracking purchases individually, you run a batch job that calls `send_custom_conversion_event` to push 50 purchase records at once, making it easy for your team to audit and reconcile revenue.

### Verifying ad setup.
Before launching a campaign, you run `check_capi_health` first. This confirms the API connection is active and working, saving hours of troubleshooting time later.

## Benefits

- Stop losing data when cookies die. By sending events through the API, you maintain reliable attribution for every click, regardless of browser changes.
- Get granular insights into the user journey. Using tools like `track_add_to_cart_event` and `track_start_checkout_event` lets you pinpoint exactly where users drop off before they buy.
- Automate compliance checks instantly. Before sending any data, run `get_capi_integration_guidelines` to make sure your PII is hashed correctly every single time.
- Handle complex funnels with one command. Instead of managing 10 separate tracking pixels, you call a specific tool (like `track_purchase_event`) and the whole payload goes out.
- Scale beyond standard events. Need to track something unique? Use `send_custom_conversion_event` to send any raw JSON data that Snapchat accepts.

## How It Works

The bottom line is: You tell your agent what happened on your site, and it sends that information directly to Snapchat's ad platform using an API token you provide.

1. Subscribe to this server and grab your Snapchat Conversions API Token from Ads Manager.
2. Pass that token to your AI client (Claude, Cursor, etc.).
3. Ask your agent to run a specific tool, like `track_purchase_event`, providing the necessary data payload.

## Frequently Asked Questions

**How do I start tracking purchases using track_purchase_event?**
You need to provide the transaction ID, revenue, and crucial user identifiers. Remember that you must first run `get_capi_integration_guidelines` to ensure those identifiers are properly SHA-256 hashed before sending.

**What is the difference between track_page_view_event and track_view_content_event?**
`track_page_view_event` logs that a URL was hit. `track_view_content_event`, however, tracks specific product or content IDs on the page—it's more granular for optimizing ad spend.

**If I run check_capi_health, what does it tell me?**
It checks if your connection to Snapchat Ads is currently active. If this tool reports a failure, you know the problem is with your API token or network setup before running any other tracking.

**Can I track complex interactions using send_custom_conversion_event?**
Yes. This tool lets you bypass specific endpoints and send raw JSON payloads. Use it when a conversion event doesn't fit into the standard tools like `track_add_to_cart_event`.

**What should I track if I want to measure lead generation?**
You need to combine `track_sign_up_event` for registration and use `get_capi_integration_guidelines` to ensure the user identifiers submitted match your lead source.

**When I use `get_capi_integration_guidelines`, what specific data points must I hash for compliance?**
You must SHA-256 hash all Personally Identifiable Information (PII). The guidelines provide the exact format and fields needed. This hashing process is mandatory before sending user metadata to ensure you meet Snapchat's privacy standards.

**What sequence of events should I log for a complete e-commerce funnel, using tools like `track_add_to_cart_event`?**
The ideal flow is: view product (`track_view_content_event`) -> add item to cart (`track_add_to_cart_event`) -> start checkout (`track_start_checkout_event`). Logging this sequence gives you a complete picture of user intent before purchase.

**How do I verify if an event type is supported for tracking by running `list_supported_conversion_events`?**
This tool lists every valid conversion event Snapchat accepts. Use this output to build your server logic; it prevents errors and ensures the data you send matches the platform's requirements.

**How do I find my Snapchat Conversions API Token?**
Log in to your Snapchat Ads Manager, navigate to **Business Details**, and you will find your Conversions API Token under the API tokens section.