How to Use the Merge (Unified Integration API) MCP in OpenAI Agents SDK

Run multi-agent workflows across your HRIS, ATS, and CRM stacks using OpenAI Agents SDK and our managed MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Merge (Unified Integration API) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Merge (Unified Integration API) 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 Merge (Unified Integration API) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull HRIS and ATS records directly into your OpenAI Agents SDK workflow.

The `list_employees` tool pulls active worker directories directly into your Python environment without manual API mapping. This MCP Server exposes raw JSON payloads containing payroll-ready details, department structures, and organizational hierarchies. Your agent uses `list_candidates` to match those internal profiles against active recruiting pipelines. This setup lets you run automated background checks or coordinate internal transfers using real-time applicant tracking data.

Map accounts and inspect connection states on the fly.

The `get_account_details` tool exposes the limits and configurations of each linked customer platform. You see exactly which third-party APIs are connected, their rate limits, and authentication statuses. Combining this tool with `list_accounts` gives your agent the context it needs to route queries correctly. It prevents your system from hitting dead ends or querying inactive customer instances.

Link customer contacts to active help desk issues.

The `list_contacts` tool extracts customer touchpoints directly from your sales pipeline records. It acts as the primary lookup mechanism for identifying high-value accounts. When users report issues, your agent calls `list_tickets` to cross-reference their account tier with their open support cases. This prevents support agents from working in silos and keeps customer success teams updated.

Setup guide

Set up Merge (Unified Integration API) 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 Merge (Unified Integration API) tools at runtime.
3

Create your Agent

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

Run the agent

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

You pass your Vinkius endpoint token directly into the MCPServerStreamableHttp constructor. Vinkius handles the underlying API headers and token rotation for each downstream HRIS or CRM tool, so your agent never manages raw credentials.

Yes, you can route specific tasks to specialized agents. For instance, one agent can use `list_employees` to audit internal staff, then hand the session over to a recruiting agent that calls `list_candidates` to fill open roles.

The Python runtime processes the standard page parameters returned by the endpoint. Your agent can read the pagination metadata in the response payload and make subsequent calls until it retrieves the full employee directory.

It does. When you register the server stream, the SDK automatically parses the schema definitions for all eight tools, including `list_tickets` and `list_companies`, making them instantly available to your agent.

Your employee records, job applications, and support tickets pass through an ephemeral, zero-trust V8 sandbox. Vinkius never stores your customer data on disk, and all transit occurs over encrypted TLS connections.

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