# Amazon Marketing Cloud MCP for AI Agents AI Agent Connect

> Amazon Marketing Cloud MCP connects your AI agent to professional cross-channel advertising analytics. It lets you run complex SQL queries, manage automated workflows, and grab secure download URLs for reports without jumping between the AWS console and your data tools. It's built for high-level marketing intelligence.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_im4kYeyTbSMqZOudko7I4MxH8XnNcyWNp4QSF0Ar/ai-agent-connect
- **Tags:** clean-room, sql-queries, cross-channel-analytics, privacy-safe, data-pipelines, marketing-intelligence

## Description

This Connector connects your AI agent to Amazon Marketing Cloud (AMC) to handle professional cross-channel advertising analytics. Instead of manually navigating the AWS console to build queries or watch progress bars, you can just tell your agent what data you need. You can ask it to trigger specific SQL-based workflows, check if they're finished, or grab the final S3 download links for your reports. It handles the heavy lifting of data pipelines so you can focus on the strategy. By using this Connector through the Vinkius catalog, you get a direct line to your AMC instance, making it much faster to organize multi-touch attribution queries or audit your execution history. You get the results you need in a natural conversation rather than through a maze of menus. This tool manages your SQL workflows and handles the heavy lifting of data processing. You can ask your agent to see what's available and trigger new reports. It lets you monitor the status of your queries in real-time or cancel any that are taking too long. It even handles the retrieval of secure S3 links, so you don't have to hunt for them in the AWS dashboard. You can organize your workspace by creating new tasks or modifying existing ones as your needs change. It turns a manual, multi-step console process into a simple conversation where you just ask for the data and get the results.

## Tools

### list_workflows
See all your saved AMC workflows in one list. Use this to find the right query to run.

### get_workflow_details
See the specific details of a workflow. Use this to check the configuration before you run it.

### create_workflow
Make a new AMC workflow from scratch. This helps you standardize your recurring analytics tasks.

### update_workflow
Change the settings of an existing AMC workflow. This lets you tweak your queries without deleting them.

### delete_workflow
Remove a workflow you no longer need. This keeps your analytics workspace clean.

### list_executions
See a history of your recent query runs. Use this to audit past activity.

### create_execution
Run an AMC query or a saved workflow. This starts the actual data processing.

### get_execution_status
Check if your query is pending or finished. Use this to know when your data is ready.

### get_execution_download_urls
Get the secure link to your finished report. Use this to grab your results from S3.

### delete_execution
Cancel a query that's taking too long. This stops stalled processes from wasting your time.

## Prompt Examples

**Prompt:** 
```
Show me my saved AMC workflows.
```

**Response:** 
```
I've retrieved your saved workflows. You have 5 workflows available, including **Campaign Overlap Analysis** and **Path to Conversion**. 

Which one would you like to run?
```

**Prompt:** 
```
What's the status of the query I just ran?
```

**Response:** 
```
I've checked the status of your recent execution. 

- **Status**: `COMPLETED` 
- **Query**: Multi-channel Attribution 

Your results are ready. Would you like me to grab the download link for you?
```

**Prompt:** 
```
Run the 'Audience Overlap' workflow and give me the link when it's done.
```

**Response:** 
```
I've triggered the **Audience Overlap** workflow. 

- **Execution ID**: `exec-99821` 
- **Status**: `PENDING` 

AMC processes these queries asynchronously. I'll monitor the progress and send you the S3 download link as soon as it's finished.
```

## Capabilities

### Trigger SQL workflows
Start complex marketing queries using your existing saved workflows from a chat interface.

### Monitor query progress
Check the real-time status of your running analytics jobs to see when they finish.

### Fetch report links
Get secure S3 download URLs for finished execution outputs directly in your conversation.

### Manage saved workflows
Create, update, or delete AMC workflows to keep your analytics organized and up to date.

### Audit execution history
Review past query results and status to track your marketing data over time.

## Use Cases

### Analyzing audience overlap
A media buyer asks the agent to run a specific workflow and check the status until the report link is ready.

### Updating recurring queries
An analyst asks the agent to modify the existing workflow configuration so they don't have to rebuild the pipeline.

### Cleaning up stalled tasks
A marketing engineer asks the agent to stop a stalled query and remove a workflow they no longer need.

### Quick report generation
A strategist asks the agent to find their saved workflows, pick the right one, and trigger the execution.

## Benefits

- Stop clicking through the AWS console to trigger queries by using create_execution to start workflows from chat.
- Get your report links faster by using get_execution_download_urls to grab S3 links as soon as they're ready.
- Keep your analytics organized by using list_workflows and delete_workflow to manage your workspace.
- Monitor your data pipelines in real-time with get_execution_status to see if a job is pending or done.
- Audit your marketing history easily with list_executions to keep track of all past query results.
- Tweak your queries without losing your setup by using update_workflow to modify existing configurations.

## How It Works

The bottom line is you get to run and manage complex advertising analytics using natural language.

1. Connect your AMC Instance ID, Client Secret, and other credentials to the Connector.
2. Tell your agent to run a specific workflow or execute an ad-hoc SQL query.
3. Receive the status updates and the final download link for your report.

## Frequently Asked Questions

**Can I run SQL queries on Amazon Marketing Cloud with this?**
Yes, you can execute ad-hoc queries or run saved workflows via your agent. It handles the connection to AMC so you don't have to deal with the console.

**How do I get my report results?**
The Connector fetches the secure S3 download URL for you once the query finishes. You can just ask your agent for the link.

**Can I manage my workflows?**
Yes, you can create, update, and delete workflows to keep your analytics organized. Your agent can handle these management tasks on your behalf.

**Is this good for cross-channel analytics?**
It's built specifically for that, making it easy to run multi-touch attribution queries and see audience overlap across different channels.

**How do I see my past query history?**
You can ask your agent to list recent executions to audit your previous runs and see what data has been processed.

**Can I stop a query that's taking too long?**
Yes, you can ask your agent to cancel any stalled or long-running executions to free up your processing queue.

**How do I find my Amazon Ads API credentials?**
You need to create a 'Login with Amazon' application in the Amazon Developer Console to get your Client ID and Client Secret. Then, you generate a Refresh Token. You also need your AMC Instance ID.

**What is an AMC workflow?**
A workflow in AMC is a saved SQL query. You can save complex queries as workflows and then execute them repeatedly by triggering a workflow execution.

**How do I get the results of my query?**
Query executions are asynchronous. First, trigger an execution. Then, check its status. Once the status is COMPLETED, use the `get_execution_download_urls` tool to get a pre-signed S3 link to download the CSV data.