# Chewy Ads MCP

> Chewy Ads MCP connects your ad account directly to any AI agent, giving you conversational control over retail media performance. List campaigns, audit keyword success, check current budget status, or pull detailed reports—all without opening the Chewy dashboard.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** retail-media, sponsored-products, campaign-management, ad-performance, keyword-optimization

## Description

Managing paid pet product advertising shouldn't mean staring at complex dashboards and clicking through five different tabs just to find a single number. This MCP lets you talk directly to your ad account data. You can ask things like, 'What was the performance for puppy food last month?' or 'List all my current campaigns.' The system pulls campaign details instantly, so you don't have to manually pull reports and cross-reference them in a spreadsheet.

If you need to audit keywords across multiple ad groups, your agent can map out that structure using natural language. It handles the deep logistics—retrieving performance metrics, listing product catalogs, and checking account balances—and gives you plain text answers. You connect this MCP via Vinkius, giving any compatible AI client immediate access to all of Chewy's advertising data so your team stays focused on marketing, not dashboard navigation.

## Tools

### get_chewy_account_balance
Provides the current account spending balance and budget status in real-time.

### get_campaign_details
Retrieves specific, detailed information for one ad campaign.

### get_performance_report
Pulls a detailed performance report for a specific date range or period.

### list_campaign_adgroups
Lists all the distinct ad groups that exist inside one specific campaign.

### list_adgroup_ads
Lists all the individual product ads contained within one ad group.

### list_chewy_campaigns
Generates a comprehensive list of every active and inactive ad campaign in your account.

### list_chewy_catalogs
Shows you all product catalogs that have been synced with the ad account for use.

### list_adgroup_keywords
Outputs keywords and their associated performance metrics for a given ad group.

## Prompt Examples

**Prompt:** 
```
List all my active campaigns in Chewy Ads.
```

**Response:** 
```
Retrieving your active campaigns... I found 3: 'Puppy Food Launch', 'Cat Litter Promo', and 'Summer Treats'. Would you like to see the performance for any of these?
```

**Prompt:** 
```
What is my current account balance?
```

**Response:** 
```
Checking your account balance... Your current remaining budget is $1,250.00, and your daily cap is set to $100.00 across all active campaigns.
```

**Prompt:** 
```
Show me the top 5 keywords for the 'Cat Litter' ad group.
```

**Response:** 
```
Retrieving keywords for 'Cat Litter'... The top 5 by impressions are: 'clumping litter', 'dust free litter', 'cat sand', 'unscented litter', and 'odor control'.
```

## Capabilities

### View Campaign Status
Get a full list and detailed status for every ad campaign you run.

### Analyze Performance Metrics
Pull historical data including clicks, impressions, and total spend for specific time periods.

### Track Spending and Budgets
Instantly retrieve the current account balance and how much budget remains.

### Audit Keyword Lists
List keywords within an ad group and see their associated performance data.

### Examine Ad Group Structure
Map out all the specific ads organized under a given ad group.

## Use Cases

### Checking Budget Before Launch
A brand owner needs to know if they have enough money for a big sale. They ask their agent, 'What is my current account balance?' The system uses `get_chewy_account_balance` and immediately tells them the remaining budget, preventing an overspend.

### Comparing Two Campaigns
An e-commerce manager wants to compare two different product lines. They ask their agent to run `get_performance_report` for both campaigns across May and June. The system pulls the metrics, allowing a quick ROI comparison.

### Finding Underperforming Keywords
A marketing specialist suspects certain keywords are dragging down performance. They ask to list keywords for 'Cat Litter' using `list_adgroup_keywords`, instantly identifying terms with high spend but low impressions.

### Verifying Product Sync Health
A retail media team needs to ensure their product feed is ready. They run `list_chewy_catalogs` and verify that the latest version of their pet supplies catalog synced correctly for advertising.

## Benefits

- Instead of manually listing campaigns, use `list_chewy_campaigns` to get a full roster of every ad running in your account instantly.
- Always know where you stand financially. Use `get_chewy_account_balance` to verify the remaining budget status without opening any billing dashboards.
- Stop guessing about keyword performance. Run `list_adgroup_keywords` to get a direct list of search terms and how they performed within an ad group.
- Understand your entire structure by using `list_campaign_adgroups`, which maps out the hierarchy of ads nested inside a campaign.
- Pull deep insights with `get_performance_report`. This tool allows you to pull metrics like clicks and impressions for any specified period.

## How It Works

The bottom line is that you manage your pet product ad spending by talking to it, not by clicking through menus.

1. Subscribe to this MCP and input your Chewy Ads API Key and Client ID from your PromoteIQ dashboard.
2. Your AI client connects using those credentials, establishing access to your advertising data.
3. You ask a question in plain English, like 'What was the performance report for Q2?', and your agent returns the specific metrics directly.

## Frequently Asked Questions

**How do I check my budget with the get_chewy_account_balance tool?**
You ask your agent to use `get_chewy_account_balance`. It returns the current remaining balance and any daily cap limits, so you know exactly how much spending money is available.

**What if I want performance data for multiple ad groups? Do I need list_adgroup_keywords?**
Yes. If you want keyword performance metrics, you first use `list_campaign_adgroups` to find the group name, and then you run `list_adgroup_keywords` while specifying that group name.

**Can I list all my campaigns at once? What tool should I use?**
Use `list_chewy_campaigns`. This single function returns a full roster of both active and inactive campaigns in your entire account, letting you see everything at a glance.

**What is the difference between list_adgroup_ads and get_campaign_details?**
`get_campaign_details` gives high-level information about the campaign as a whole. `list_adgroup_ads` focuses only on the specific ads that are running within one particular ad group.

**If I need performance metrics for a specific period, how do I use the get_performance_report tool?**
You specify the start and end dates in your request. This lets you analyze trends across custom date ranges, giving you a historical view beyond just current daily data points.

**Before running new ads, how do I check if my product inventory is ready using list_chewy_catalogs?**
The tool lists all product catalogs currently synced with your ad account. Use this to quickly verify that your product data is current and correctly linked, preventing potential ad errors.

**How can I map out the entire structure of a campaign using list_campaign_adgroups?**
It lists every ad group contained within a specified campaign. This helps you quickly visualize the full hierarchy, making it easier to pinpoint exactly where optimization efforts should focus.

**What credentials are required to run a basic command like list_chewy_campaigns?**
You must provide your Chewy Ads API Key and Client ID. These keys are obtained directly from your PromoteIQ dashboard, which authorizes the MCP for secure access.

**Can I see my advertising spend for this month?**
Yes! Use the `get_performance_report` tool with your desired date range. The agent will retrieve your spend metrics along with impressions and clicks.

**How do I check the status of a specific ad group?**
Use the `list_campaign_adgroups` tool with your campaign ID. Your agent will fetch all ad groups and their current states (e.g., Active, Paused).

**Where do I find my Chewy Ads API Key and Client ID?**
These credentials are provided through the Chewy Ads / PromoteIQ dashboard. Log in to your advertiser portal and look for the 'API' or 'Developer' settings section.