How to Use the Refiner MCP in OpenAI Agents SDK

Use the Refiner MCP Server to pipe survey data directly into your OpenAI Agents SDK workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Refiner MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate user feedback in OpenAI Agents SDK

Trigger `list_refiner_surveys` to pull active feedback loops directly into your agent's reasoning cycle. Your agent gets the raw survey data to inform its next step without manual intervention. Once the survey is identified, call `list_refiner_responses` to inject user sentiment into your guardrails. This keeps your production agents grounded in real-time customer data.

Manage Refiner users with OpenAI Agents SDK

Update user profiles on the fly by calling `identify_refiner_user`. You can sync external state changes immediately after an agent detects a churn signal or a feature request. Use `track_refiner_event` to log agent-driven actions back into your feedback loop. This closes the circle between your agent's behavior and the metrics you track in your dashboard.

Contextualize contact data for OpenAI Agents SDK

Run `list_refiner_contacts` to give your agent a list of active users for targeted outreach. The agent can then use `get_refiner_contact` to pull specific details before drafting a personalized response. Your agent knows exactly who it's talking to because it can query segments using `list_refiner_segments`. This setup turns your agent into an active participant in your customer success strategy.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the server via Vinkius and define it using the MCPServerStreamableHttp class. Pass your endpoint URL to the constructor and add the server to your Agent's tool list for auto-discovery.

Yes. Your agent uses the tracking tool to push events back to the server whenever it completes a task or identifies a specific user behavior.

The server exposes specific tools that your agent can trigger only when the guardrails allow it. This ensures your agent's feedback logic stays within your defined production boundaries.

The agent will catch the connection error during the tool execution phase. You should implement standard try-except blocks in your Python code to handle these network interruptions gracefully.

Your customer names, email addresses, and survey responses remain encrypted in transit. Vinkius provides an ephemeral sandbox, meaning no data persists on our infrastructure after the session ends.

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