How to Use the Amazon Ads MCP in OpenAI Agents SDK

Q: How do I connect Amazon Ads to the OpenAI Agents SDK?

Initialize the connection using MCPServerStreamableHttp. Pass your Vinkius endpoint URL into MCPServerStreamableHttpParams, then drop that MCP Server object into your Agent constructor's mcpservers list. The SDK handles tool discovery automatically.

Q: Does the Amazon Ads integration support multiple advertiser profiles?

It handles multiple accounts natively. Your agent fires listprofiles to grab the available IDs. It then passes the required profile ID into subsequent tool calls to ensure it queries the correct brand.

Build production-grade Amazon Ads agents with OpenAI Agents SDK. Enforce strict guardrails on ad spend and campaign management.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amazon Ads MCP to OpenAI Agents SDK

Create your Vinkius account to connect Amazon Ads 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 Ads with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Amazon Ads MCP Server for Production Agents

Handing control of your advertising budget to an LLM requires strict boundaries. By connecting this MCP Server to your OpenAI Agents SDK setup, you define exact constraints before any action executes. Your specialized reporting agent can trigger `request_sp_report` to generate performance data, while a separate campaign manager handles the structural changes. Handoffs between these specialized agents happen natively within the framework. When the reporting agent confirms completion using `get_report_status`, it passes the context straight to your optimization agent. Every single tool call, from `list_sp_campaigns` to profile fetching, gets logged in your OpenAI dashboard for full auditability.

Campaign Discovery and Keyword Audits

Managing Sponsored Brands and Sponsored Products manually takes hours of clicking through the Amazon console. Your agent pulls the exact state of your account in seconds. It calls `list_profiles` to find the right advertiser ID, then maps out your entire account structure. You get immediate visibility into where your money goes. The agent runs `list_sb_campaigns` alongside `list_sp_campaigns` to build a complete picture of your active promotions. From there, it digs into specific targeting rules using `list_sb_keywords` and `list_sp_keywords`, flagging expensive terms that need your attention.

Automated Performance Reporting Pipelines

Stop downloading CSV files every Monday morning. You can schedule an OpenAI agent to handle the entire data extraction process asynchronously. It initiates the build by firing `request_sp_report` for your top-converting Sponsored Products. Polling for completion is built into the workflow. The agent checks `get_report_status` until the file is ready, then ingests the metrics. Since you are using the OpenAI SDK, you can set `cacheToolsList=True` to keep the tool discovery fast during these recurring background jobs.

Setup guide

Set up Amazon Ads 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 Ads tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Amazon Ads 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 Ads 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 Ads Agent",
            instructions="You have access to Amazon Ads 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 Ads. 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 Ads 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 Ads MCP in OpenAI Agents SDK

Initialize the connection using `MCPServerStreamableHttp`. Pass your Vinkius endpoint URL into `MCPServerStreamableHttpParams`, then drop that MCP Server object into your Agent constructor's `mcp_servers` list. The SDK handles tool discovery automatically.

Yes, through built-in guardrails. You write specific Python functions that validate arguments before the agent executes tools like `list_sp_campaigns`. If the agent tries to pull data outside your defined scope, the framework blocks the request.

It handles multiple accounts natively. Your agent fires `list_profiles` to grab the available IDs. It then passes the required profile ID into subsequent tool calls to ensure it queries the correct brand.

Everything logs directly to your OpenAI dashboard. When your agent executes `list_sp_ad_groups` or requests a report, the exact arguments and response payloads appear in your run traces. You never have to guess what the model actually did.

Vinkius isolates your account traffic within a V8 sandbox. When your agent pulls Sponsored Products keyword bids and ad group structures, the ephemeral environment processes the request and instantly dies. We hold zero persistent logs of your advertising metrics.

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