How to Use the Medallia MCP in OpenAI Agents SDK

Q: How do I set up the Medallia MCP Server in my OpenAI Agents SDK code?

Install the package, define your connection using MCPServerStreamableHttp, and pass it to your Agent constructor. Setting cacheToolsList=True ensures your agent doesn't waste latency re-fetching the tool list on every turn.

Run production agents with the OpenAI Agents SDK that safely monitor and act on Medallia customer feedback via MCP.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Medallia MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate alert triage with OpenAI Agents SDK

Using the `list_alerts` tool, your OpenAI Agents SDK agent catches customer issues before they escalate. It's built to pull deep context with `get_alert` without making you perform manual lookups. By configuring this Medallia connection within your python-based agent, the SDK handles the raw JSON payload and routes the alert to the right team. You get full execution tracing on your OpenAI dashboard, keeping every automated customer recovery step visible and audit-ready.

Targeted response analysis using the MCP Server

With the `search_responses` tool, your OpenAI Agents SDK agent digs into specific Medallia customer experience drops. It'll call `get_response` to dissect the exact metrics and text comments left by the user. The agent handles these Medallia operations within the safety parameters you set in your Python code. Because the MCP Server maps these tools directly, your OpenAI agent executes complex queries without hallucinating API paths.

Program and survey discovery on autopilot

By calling the `list_programs` tool, your OpenAI Agents SDK agent stays updated on active feedback channels. It'll discover which programs are running and use `get_survey` to understand the structure of the data it is analyzing. Setting up this discovery loop is simple with `MCPServerStreamableHttp` in the OpenAI SDK. Your agent queries the active Medallia endpoints, identifies the right survey ID, and pulls the exact customer data it needs.

Setup guide

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

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Medallia 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="Medallia Agent",
            instructions="You have access to Medallia 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 Medallia. 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 Medallia 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 Medallia MCP in OpenAI Agents SDK

The SDK automatically maps all ten tools when you initialize the server connection. Your agent reads the tool schemas at startup, allowing it to call functions like `list_surveys` or `get_alert` without manual configuration.

Yes, you can restrict tool access directly in your agent's definition. This prevents the agent from calling administrative tools like `list_users` while still letting it run queries like `search_responses` for customer feedback analysis.

Install the package, define your connection using `MCPServerStreamableHttp`, and pass it to your Agent constructor. Setting `cacheToolsList=True` ensures your agent doesn't waste latency re-fetching the tool list on every turn.

You can design a triaging agent that lists active surveys using `list_surveys` and then hands off the task to a specialist agent. The specialist agent then uses `list_responses` to pull and analyze individual customer replies.

Your survey responses, alerts, and user lists are protected by Vinkius's zero-trust sandboxed environment. No Medallia credentials or customer records are stored or exposed to external networks during execution.

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