# Adtelligent MCP MCP

> Adtelligent provides adtech orchestration via natural conversation. Your agent manages your entire advertising stack—from Demand-Side Platforms (DSPs) to Supply-Side Platform (SSP) reporting. You can audit campaigns, review creative assets, and pull granular performance stats like impressions, clicks, or revenue by specific domains or countries. It lets you talk to your ad platform instead of clicking through five different dashboards.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** adtech, dsp-management, ssp-reporting, inventory-optimization, ad-campaigns, performance-statistics

## Description

Need to manage complex advertising data but hate the dashboard sprawl? This MCP connects your agent directly to your Adtelligent account. Instead of logging into multiple portals just to check performance, you ask a question and get the answer. Your agent handles everything—checking which agencies are running what campaigns, pulling detailed revenue reports for specific domains, or auditing creative assets across dozens of campaigns. It's like having an expert ad ops specialist who lives inside your AI client. Because this MCP is hosted on Vinkius, you connect once and get immediate access to the entire catalog of tools, making it a central hub for all your marketing data needs.

## Tools

### list_advertisers
Pulls a current list of all advertisers registered within the Demand-Side Platform.

### list_campaigns
Provides an inventory count and details for active campaigns managed in the DSP.

### get_ssp_report
Retrieves detailed performance statistics from your Supply-Side Platform, requiring an authentication token.

## Prompt Examples

**Prompt:** 
```
List all active advertisers in my Adtelligent DSP.
```

**Response:** 
```
I've retrieved the list of advertisers. You have 12 active advertiser accounts, including 'Premium Brand A', 'Tech Solutions', and 'Global Retail'. Would you like to check the active campaigns for any of them?
```

**Prompt:** 
```
Show me an SSP performance report for yesterday by domain.
```

**Response:** 
```
I've pulled the SSP statistics for yesterday. Your top-performing domains were 'news-site.com' (500k impressions) and 'blog-network.net' (300k impressions). Total revenue generated was $1,250.
```

**Prompt:** 
```
List all audience segments for agency ID 12345.
```

**Response:** 
```
I've retrieved the audience segments for agency 12345. There are 5 segments configured, including 'High Intent Tech Buyers' and 'Frequent Travelers'. Would you like to see the targeting rules for these segments?
```

## Capabilities

### Audit Advertiser Accounts
You can retrieve lists of advertisers running campaigns through your Demand-Side Platform.

### List Active Campaigns
The MCP pulls a current list of all active advertising campaigns managed within the system.

### Generate Performance Reports
You get detailed SSP reports, including metrics like impressions and revenue, filtered by domain or country.

## Use Cases

### Checking Q3 Revenue Drops
A publisher sees a revenue drop and asks their agent: 'What was my total revenue yesterday?' The agent calls `get_ssp_report` to pull the stats, identifies the underperforming domains, and reports back $1.2M in total revenue.

### Onboarding a New Agency
An Ad Ops Specialist needs to audit an agency's setup. They ask their agent to 'Show me all advertisers for Agency XYZ.' The agent calls `list_advertisers`, giving the specialist a clean list of accounts they need to review.

### Auditing Campaign Scope
A Media Buyer needs to know if two campaigns overlap. They ask their agent to first run `list_campaigns` and then reference the IDs, quickly comparing campaign details without opening separate dashboards.

## Benefits

- Stop manually checking dashboards. You can get granular SSP reports instantly using `get_ssp_report`, pulling data sliced by country or specific domain name.
- Quickly verify who is running ads and what they're doing. Use `list_advertisers` to audit all current advertiser accounts in one simple call.
- Streamline campaign checks. You can run `list_campaigns` to get an immediate overview of every active campaign, helping you spot delivery issues fast.
- Handle complex reporting data—like cross-channel ROI analysis—by having your agent compile information from multiple sources into a single response.
- Focus on strategy, not clicks. The MCP handles the tedious work of combining advertiser lists with campaign performance data for you.

## How It Works

The bottom line is, your agent translates complex ad platform jargon into simple answers you can use right away.

1. Subscribe to this MCP and enter your Adtelligent DSP Credentials or SSP Auth Token.
2. Your agent recognizes the adtech connection and is ready for commands through any compatible client.
3. You simply ask a natural language question, like 'Show me yesterday's revenue report for news-site.com,' and get the data back immediately.

## Frequently Asked Questions

**Where do I find my Adtelligent SSP Token?**
The SSP auth token is unique to your account and must be requested from the Adtelligent Support Team. Once requested, it will be sent to the registered email address for your account.

**Can I manage both DSP and SSP via this server?**
Yes! This server includes dedicated tools for DSP entity management (campaigns, creatives) and SSP reporting (granular performance stats).

**Does it support video creative uploads?**
The DSP tools allow you to list and audit video creatives. For large file uploads, we recommend using the Adtelligent dashboard, but technical metadata can be retrieved via the agent.

**If I run `get_ssp_report` and get an error, what is the first thing to check?**
You should first verify your SSP Auth Token. Most errors relate to expired or revoked credentials. Re-authenticating your MCP connection usually solves this.

**How do I specify a date range when calling `get_ssp_report`?**
The tool accepts optional start and end dates for filtering. You simply pass these parameters to limit the performance window of your SSP data.

**Can I use `list_campaigns` to check multiple campaign IDs at once?**
Yes, it supports batch retrieval. Just provide a list or array of specific Campaign IDs; the agent will compile all requested campaigns in one call.

**What is the expected input format when calling `list_advertisers`?**
It expects an alphanumeric ID or a list of multiple IDs. Ensure your prompt formats these as distinct identifiers, not a single block of text.

**Are there rate limits if I run `get_ssp_report` repeatedly in quick succession?**
The underlying API has usage caps. If you exceed the limit, your agent will flag it and suggest pacing your requests or waiting a set period.