# Moloco MCP

> Moloco lets you manage programmatic ad spend and performance directly through conversation. List all your advertising accounts, check balances, track campaign status, or pull deep analytics reports without ever logging into a dashboard. Just tell your agent what you need to know about your campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** programmatic-advertising, machine-learning, ad-campaigns, mobile-growth, ad-performance, marketing-analytics

## Description

You connect Moloco Ads to your AI client, and you start managing complex ad campaigns using natural conversation. Instead of jumping through five different dashboards just to get a status update or check a budget balance, you simply ask your agent. It gathers the data from across your accounts—showing you everything from high-level account balances to specific conversion events.

Need to know if a campaign is underperforming? Ask for a performance report for last Tuesday and compare it against another segment. You can also get granular details by listing ad groups or creative assets, helping you understand exactly where your spending goes. If something looks off, tell the agent to update the campaign status—it handles the API call for you. The whole process is orchestrated through Vinkius, making Moloco Ads accessible from any MCP-compatible client right in your existing workflow.

## Tools

### get_account_balance
Checks the current monetary balance of a specific ad account.

### get_analytics_report
Generates and fetches detailed performance analytics for a specified time range.

### get_campaign
Retrieves all specific configuration details and metadata for one campaign.

### list_ad_accounts
Lists every connected advertising account under your profile.

### list_ad_groups
Provides a list of ad groups that belong to an active campaign.

### list_campaigns
Lists all campaigns associated with a primary ad account.

### list_conversions
Retrieves a list of recorded conversion events for tracking and analysis.

### list_creative_groups
Lists all creative asset groups used within your ad campaigns.

### list_tracking_links
Retrieves a list of attribution tracking links for measurement purposes.

### update_campaign_status
Changes the status of an existing campaign to enabled or paused.

## Prompt Examples

**Prompt:** 
```
List all active campaigns in my primary AdAccount.
```

**Response:** 
```
I've fetched the campaigns for AdAccount 'AC-12345'. You have 4 active campaigns: 'Summer Sale 2024', 'Brand Awareness - Global', and 2 others. Shall I retrieve the performance report for 'Summer Sale 2024'?
```

**Prompt:** 
```
Pause the campaign with ID cp_98765.
```

**Response:** 
```
Status update initiated... The campaign 'cp_98765' has been successfully PAUSED. I'll continue to monitor your account balance and other active campaigns.
```

**Prompt:** 
```
Check the balance for AdAccount AC-12345.
```

**Response:** 
```
Retrieving balance... Your AdAccount AC-12345 has a remaining balance of $2,450.00 with a daily budget threshold of $500.00. Based on your current spend, this should last for approximately 5 days.
```

## Capabilities

### View Account Health
List all connected ad accounts and check their current spending balances.

### Monitor Campaign Status
Fetch a list of campaigns within an account, or update a campaign's status to enabled or paused.

### Generate Performance Reports
Pull detailed analytics reports for specific time frames to track return on investment and engagement metrics.

### Inspect Campaign Details
Retrieve deep configuration information, metadata, and performance data for any single campaign.

### Track Conversions
View a list of recorded conversion events and monitor the associated attribution tracking links.

## Use Cases

### Ad Spend Review
The Growth Manager needs to know if the 'Q3 Retargeting' campaign is running over budget. They ask their agent for the account balance and then request a performance report, immediately confirming that the spend remains within safe limits.

### Crisis Management
The Ad Ops Specialist notices one campaign has zero clicks after 48 hours. Instead of digging through settings, they ask their agent to list all campaigns and then specifically use `update_campaign_status` to pause the problematic ad.

### Campaign Audit
The Marketing Analyst needs a full inventory of every asset group and tracking link for an audit. They simply ask the agent, which runs both `list_creative_groups` and `list_tracking_links`, providing two complete lists in one response.

### Daily Checkup
The Growth Manager wakes up and asks their agent for a summary of ad account health. The agent runs `list_ad_accounts` to check balances, then calls `list_campaigns` to provide an immediate overview of what's running.

## Benefits

- Check account balances instantly. Instead of manually logging into the Moloco portal to check budget caps, you simply ask your agent for the balance using `get_account_balance`.
- Automate status changes. Need to pause a failing campaign? Use `update_campaign_status` via conversation instead of navigating deep menus and clicking radio buttons.
- Deep performance insight. Pulling reports is easy with `get_analytics_report`. You get structured data on ROI without having to build custom query filters.
- Full visibility into assets. Easily list everything from ad groups (`list_ad_groups`) to creative asset groups (`list_creative_groups`), giving you a full view of your targeting structure.
- Streamlined reporting. The `list_conversions` tool pulls conversion events and attribution links, saving you the time of exporting data into separate sheets.

## How It Works

The bottom line is that you treat managing complex advertising accounts like chatting with a knowledgeable teammate who has direct access to your backend data.

1. Subscribe to this MCP in Vinkius, then provide your Moloco API key.
2. Tell your agent what you need done—for example, 'What is the balance for my main ad account?'
3. The agent runs the necessary tools and returns actionable data or confirmation of status changes.

## Frequently Asked Questions

**How does Moloco help me check campaign balances using the Moloco MCP?**
You use the `get_account_balance` tool to instantly see your ad account's remaining budget. This prevents overspending and helps you manage cash flow without logging into a separate portal.

**Can I pause or change an ad campaign status with the Moloco MCP?**
Yes, the `update_campaign_status` tool lets you programmatically change statuses. You can tell your agent to PAUSE or ENABLE a specific campaign ID immediately.

**What kind of reports does the get_analytics_report tool provide?**
The `get_analytics_report` generates comprehensive performance data, allowing you to track ROI and engagement metrics over custom time periods. You don't have to manually filter dates in a dashboard.

**Does the Moloco MCP help me see which ad groups I’m running?**
Yes, if you know the campaign name, you can use `list_ad_groups` to get an inventory of all associated ad groups. This helps map out your targeting structure.

**Is it possible to list conversion data with Moloco MCP?**
Absolutely. The `list_conversions` tool fetches recorded conversion events and monitors the attribution tracking links, giving you a clear picture of what's working.