How to Use the Freshteam MCP in OpenAI Agents SDK

Q: How do I set up the Freshteam MCP Server with the OpenAI Agents SDK?

Install the SDK with pip install openai-agents and instantiate MCPServerStreamableHttp using your Vinkius endpoint. Pass this server in the mcpservers list to your Agent constructor and set cacheToolsList=True to speed up tool discovery.

Q: How does caching improve tool discovery performance?

Setting cacheToolsList=True prevents the SDK from querying the server endpoint on every single turn. This reduces latency when your agent frequently calls tools like listemployees or listdepartments.

Build production-ready HR agents that safely manage Freshteam operations using the OpenAI Agents SDK with built-in execution guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshteam MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe employee onboarding with OpenAI Agents SDK

The `create_employee_record` tool on this MCP Server writes new hires directly to your Freshteam HR directory. When you deploy this tool through the OpenAI Agents SDK, the framework intercepts the write command to run your custom guardrails, keeping bad inputs out of your system. You get full tracing on the OpenAI dashboard for every single execution. The SDK handles the handoff between your recruiting agent and your HRIS agent, ensuring the record creation happens only after verifying the candidate's final status in Freshteam.

Smart applicant filtering and routing

The `get_applicant_details` tool retrieves deep candidate profiles to help your AI run initial screenings. Your OpenAI Agents SDK setup uses specialized agents to parse these profiles and coordinate interview scheduling within Freshteam. By using `list_job_applicants` alongside `list_job_postings` on this MCP, the agent maps incoming resumes to open roles. If a candidate fits a different role, one OpenAI agent hands off the task to another specialized team agent with zero lag.

Real-time HR status tracking

The `check_hris_status` tool verifies your connection to the Freshteam platform before running any complex queries. This prevents your OpenAI Agents SDK pipeline from hanging or throwing unhandled errors when the external API goes down. Agents use `list_time_off_requests` to monitor team availability and cross-reference active leaves in Freshteam. You see every API call on your central OpenAI dashboard, so you can audit exactly what data your agent read.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK with `pip install openai-agents` and instantiate `MCPServerStreamableHttp` using your Vinkius endpoint. Pass this server in the `mcp_servers` list to your Agent constructor and set `cacheToolsList=True` to speed up tool discovery.

Yes, because the SDK supports strict pre-execution guardrails. When an agent calls `create_employee_record`, the SDK validates the payload against your rules before hitting the live API.

You build specialized agents—one for recruiting and one for core HR operations. The recruiting agent uses `get_applicant_details` and then hands off to the HR agent to execute `create_employee_record` once the candidate accepts.

Setting `cacheToolsList=True` prevents the SDK from querying the server endpoint on every single turn. This reduces latency when your agent frequently calls tools like `list_employees` or `list_departments`.

Your employee records and applicant details remain protected inside the Vinkius V8 isolate sandbox. No PII is stored on our servers, and every token-authorized request is immediately wiped from memory after 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