# Kevel MCP

> Kevel connects your advertising operations directly to any AI client. This MCP manages ad campaigns, inventory sites, and creatives using natural language commands. You'll use it to list advertisers, check campaign configurations, pull zone details for specific sites, or audit creative assets without logging into the Kevel dashboard. It gives your agent hands-on control over complex ad serving processes.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** ad-serving, ad-ops, campaign-management, inventory-management, ad-tech, api-integration

## Description

Kevel lets you run your ad operations straight through your AI client. Instead of navigating multiple dashboards to track campaigns or check inventory health, you just ask your agent what you need. You can pull up detailed reports on campaign structures, query specific advertiser metadata, or list all available zones for a site ID. This MCP makes managing everything—from the initial campaign setup to the final ad creative audit—a conversation with your agent.

This level of granular control means product managers and ad operations teams get immediate answers without clicking through tabs. If you're building an automated workflow, Vinkius hosts Kevel, letting your AI client access these tools alongside thousands of others. You simply tell your agent to 'list all active flights for the summer sale,' and it executes the API call instantly.

## Tools

### get_campaign
Gets specific details about a single campaign you specify.

### list_zones
Lists all the designated ad placement zones across your network.

### list_ad_types
Retrieves a list of supported ad formats, like banner or native placements.

### list_ads
Lists all the individual ads currently uploaded to your account.

### list_advertisers
Provides a comprehensive list of every advertiser managed in Kevel.

### list_campaigns
Lists all the active and archived campaigns currently running.

### list_channels
Retrieves a list of all associated channels used for ad serving.

### list_creatives
Lists every creative asset that has been uploaded to the account.

### get_advertiser
Retrieves specific details for a single, named advertiser.

### list_flights
Lists all ad flights associated with your campaigns.

### list_sites
Lists every site that is part of the advertising network.

## Prompt Examples

**Prompt:** 
```
Show me all active campaigns in Kevel.
```

**Response:** 
```
I've retrieved your campaigns. You have 10 active campaigns, including 'Summer Sale 2024' and 'New Product Launch'. Would you like to see the flights for any of them?
```

**Prompt:** 
```
List all ad zones for the site with ID 12345.
```

**Response:** 
```
I found 5 zones for site 12345: 'Header Banner', 'Sidebar Native', and 3 others. All zones are currently active.
```

**Prompt:** 
```
What ad types are supported in my Kevel account?
```

**Response:** 
```
I've listed the supported ad types. Your account supports 15 formats, including 'Banner', 'Native', 'Video', and 'Interstitial'.
```

## Capabilities

### Audit ad creatives
You can get a full list and detailed status of every creative asset uploaded to the account.

### Manage campaign details
Retrieve specific information about campaigns, including their current configuration and related flights.

### Check site inventory zones
List all ad placement zones for a given website or channel to ensure proper ad delivery.

### Query advertiser data
Pull metadata and specific details about any advertising entity within the system.

### Inspect site placements
List all sites that are currently active in your ad serving network, checking for availability.

## Use Cases

### A client asks about campaign performance across 10 channels.
Instead of logging into Kevel, the agent runs `list_campaigns` to get a list, then calls `list_flights` for each one. It compiles a single summary showing which campaigns are active and how many flights they have running.

### I need to validate if our new website section supports native ads.
The agent first runs `list_ad_types` to confirm 'Native' is supported. Then, it uses `list_zones` and specifies the site ID to ensure there's an actual available ad placement zone for that format.

### We suspect a major advertiser's profile data needs updating.
You ask your agent about 'Acme Corp.' The agent executes `get_advertiser` and pulls all the required metadata, which you can then review and pass to your internal CRM.

### My team is onboarding a new site and needs to know its full inventory scope.
The agent calls `list_sites` for general coverage, followed by `list_channels` to understand the full range of distribution options available on that platform.

## Benefits

- Audit creatives instantly: Use `list_creatives` to get a complete list of all your ads, so you never have to guess if an asset was uploaded correctly.
- Control ad spend visibility: You can use `list_campaigns` and then `get_campaign` to pull detailed status reports on specific campaigns in seconds.
- Verify placements easily: If you need to know what zones are available for a new client, running `list_zones` gives you the technical details right away.
- Manage relationships quickly: Use `list_advertisers` or `get_advertiser` to pull metadata on specific companies without needing their account login credentials.
- Check network availability: Running `list_sites` ensures that all your designated ad placements are online and ready for traffic.

## How It Works

The bottom line is that once connected, your AI agent treats Kevel like a native function within its own command set.

1. Subscribe to the Kevel MCP and enter your required API key.
2. Connect this MCP to your preferred AI client (like Cursor or Claude).
3. Tell your agent exactly what you need—for example, 'List all zones for site X'—and it executes the request.

## Frequently Asked Questions

**How do I find out what ad zones are available with Kevel?**
You use the `list_zones` tool. You must provide a specific site ID for the tool to list the correct and available placement zones on that website.

**Can I check which campaigns are running using Kevel MCP?**
Yes, you can use `list_campaigns` to get a full overview of all campaign IDs. After getting the ID, you run `get_campaign` for detailed status information.

**Does Kevel allow me to list ad creatives by type?**
You can use `list_creatives` to pull every asset uploaded. While it doesn't filter by type, you can then check the metadata of each creative to audit its format.

**What is the difference between `list_sites` and `list_channels` in Kevel?**
`list_sites` gives you a list of physical web properties (the placement location). `list_channels` provides a list of distribution methods or pathways for serving ads.

**How do I get details on a specific advertiser using Kevel MCP?**
You must use the `get_advertiser` tool and provide the unique identifier for that advertiser. This pulls all associated metadata in one go.