How to Use the Amazon Marketing Cloud MCP in OpenAI Agents SDK

Q: Can my agent get query results from Amazon Marketing Cloud using the OpenAI Agents SDK?

Yes. After an execution finishes, your agent calls getexecutiondownloadurls. This returns signed URLs for the output files, which your agent can then download and use.

Q: What if I need to cancel a running query in Amazon Marketing Cloud with my OpenAI Agents SDK agent?

No problem. Just have your agent call the deleteexecution tool with the execution ID. This sends a cancellation request to AMC and stops the query.

Build production-grade agents that run Amazon Marketing Cloud analytics. A perfect fit for the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amazon Marketing Cloud MCP to OpenAI Agents SDK

Create your Vinkius account to connect Amazon Marketing Cloud to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Amazon Marketing Cloud with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run & Manage AMC Analytics

Your agent can now run your most complex advertising queries. Use `create_execution` to kick off a new SQL job in AMC. Your agent doesn't just fire and forget; it can monitor the job's progress with `get_execution_status`. Once a query is complete, the agent gets the results. The `get_execution_download_urls` tool provides secure, temporary links to the output data. This lets your agent pull down analytics reports for further processing or storage, closing the loop on your data pipeline.

Automate Workflows with the OpenAI Agents SDK

This MCP Server puts your agent in charge of entire AMC workflows. It can spin up new ones from scratch using `create_workflow` or modify existing ones with `update_workflow`. You can build agents that dynamically adjust analytics pipelines based on campaign performance. Cleaning up is just as important. Your agent can list all current processes with `list_workflows` and `list_executions`, then decide what's no longer needed. A quick call to `delete_workflow` or `delete_execution` keeps your AMC instance tidy and prevents runaway jobs.

Get Full Visibility into Executions

Stop guessing what your analytics jobs are doing. Your agent can ask for a status update on any job at any time. The `get_execution_status` tool returns the current state, like `PENDING`, `RUNNING`, or `COMPLETED`. For a deeper look, `get_workflow_details` gives your agent the full configuration of any workflow. This is perfect for debugging or creating audit trails, all tracked within the OpenAI dashboard for full transparency.

Setup guide

Set up Amazon Marketing Cloud MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Amazon Marketing Cloud tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Amazon Marketing Cloud tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Amazon Marketing Cloud tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Amazon Marketing Cloud Agent",
            instructions="You have access to Amazon Marketing Cloud tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Amazon Marketing Cloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Amazon Marketing Cloud now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Amazon Marketing Cloud MCP in OpenAI Agents SDK

Your agent uses specific tools from this MCP Server to control workflows. It can call `create_workflow`, `update_workflow`, and `list_workflows` to manage the entire lifecycle directly from your Python code.

Yes. After an execution finishes, your agent calls `get_execution_download_urls`. This returns signed URLs for the output files, which your agent can then download and use.

No problem. Just have your agent call the `delete_execution` tool with the execution ID. This sends a cancellation request to AMC and stops the query.

Absolutely. The OpenAI Agents SDK is designed for this. You can set up guardrails that require human confirmation before an agent calls a destructive tool like `delete_workflow`.

This server only brokers requests; it doesn't store your data. Your agent gets temporary, secure URLs for AMC execution results. The actual analytics data never sits on Vinkius servers, so your customer and campaign information stays within your AMC environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript