How to Use the Breezy HR Alternative MCP in OpenAI Agents SDK

Q: How do I connect the Breezy HR Alternative to my OpenAI Agents SDK pipeline?

Install the Python SDK and configure the server using the MCPServerStreamableHttp class. Pass the Vinkius endpoint URL directly into your agent constructor under the mcpservers parameter to auto-discover all eight recruiting tools.

Q: How do I handle multiple companies with this toolset?

Use the listcompanies and getcompany tools to identify the specific entity you want to query. Once you have the company ID, you can filter positions and candidates specifically for that corporate branch.

Build production-ready recruiting agents with OpenAI Agents SDK that safely write to Breezy HR.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Breezy HR Alternative MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Direct candidate ingestion in OpenAI Agents SDK

The `add_candidate` tool lets your OpenAI agent dump new applicants right into your hiring pipelines. No manual entry required. Your Python script parses the resume and calls this function to populate the profile. You get instant validation of candidate details before they hit your database. This prevents dirty data from corrupting your pipelines, keeping your recruiting pipeline clean without manual oversight.

Expose job openings to your MCP Server

This MCP Server exposes job details through `get_position` and `list_positions` so your agents can match candidate profiles against open roles. Your system queries current job requirements directly from Breezy HR and compares them to applicant resumes. The agent evaluates skills against specific job requirements on the fly. It flags ideal matches without requiring a human recruiter to read through hundreds of postings manually.

Track application history automatically

Tracking candidate progression relies on the `list_applications` tool to pull historical application records. Your agent analyzes previous interactions to see if an applicant previously applied for other roles within the company. It maps out the candidate journey across multiple departments. This keeps your team informed about past interviews and decisions, cutting down on redundant screening calls.

Setup guide

Set up Breezy HR Alternative 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 Breezy HR Alternative tools at runtime.
3

Create your Agent

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

Run the agent

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

Install the Python SDK and configure the server using the `MCPServerStreamableHttp` class. Pass the Vinkius endpoint URL directly into your agent constructor under the `mcp_servers` parameter to auto-discover all eight recruiting tools.

Yes. While the SDK auto-discovers all tools, you can filter the tool list in Python before passing them to your agent. This ensures your agent only accesses read tools like `list_positions` and cannot write data using `add_candidate`.

Absolutely. You can route candidate screening tasks to a specialized agent using `list_candidates`, then hand off to a coordinator agent that calls `add_candidate` to finalize the profile. This keeps your agent architectures modular and clean.

Use the `list_companies` and `get_company` tools to identify the specific entity you want to query. Once you have the company ID, you can filter positions and candidates specifically for that corporate branch.

Vinkius runs this MCP Server inside an isolated V8 sandbox where all credentials are encrypted. Your candidate data and application records are processed in ephemeral memory, meaning no personal identifiable information is ever stored on our servers.

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