How to Use the Moka HR MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK automatically create candidate profiles in Moka HR?

Yes, your agent uses the createcandidate tool to add new profiles. The SDK verifies the agent's intent before executing the write command to prevent duplicate records.

Run production-grade recruiting pipelines with OpenAI Agents SDK and the Moka HR 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 Moka HR MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Screen applicants safely with OpenAI Agents SDK

The `list_candidates` tool lets your agent pull active profiles directly into your OpenAI pipeline. The SDK handles safety checks before the agent can write back to your applicant database, preventing accidental data overwrites. Once the agent identifies qualified profiles, it calls `get_candidate` to build out the full candidate context. You get strict runtime validation on every field, keeping bad resume data from breaking your downstream processing steps.

Automated interview coordination via MCP Server

The `list_interviews` tool exposes scheduled interview slots directly to your agent. This allows your system to monitor upcoming recruiter calls and flag conflicts without manual calendar checking. If a candidate requests a reschedule, the agent uses `get_interview` to pull the specific meeting details and coordinate next steps. Your team gets clean, structured data updates directly in the Moka HR platform.

Draft hiring summaries with agent handoffs

The `get_hiring_summary` tool extracts candidate performance metrics across multiple interview stages using this MCP Server. Specialized agents hand off this raw data to a synthesis agent to compile final candidate scorecards. Your agents can also query `get_application` to pull the original job post details and compare candidate qualifications against original requirements. This keeps your hiring managers aligned without digging through multiple browser tabs.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the SDK using pip install openai-agents. Initialize the server using MCPServerStreamableHttp and pass it to your Agent constructor.

Yes, your agent uses the `create_candidate` tool to add new profiles. The SDK verifies the agent's intent before executing the write command to prevent duplicate records.

The SDK uses standard HTTP backoff protocols when calling tools like `list_jobs` or `list_applications`. You can also cache the tools list to avoid redundant API handshakes.

Yes, you can route tasks between an agent that lists jobs with `list_jobs` and another that screens candidate profiles. The SDK manages state and tool access across your entire agent pool.

The server processes candidate resumes and interview feedback inside a secure V8 isolate sandbox. All authentication tokens are handled at the gateway layer, meaning your agent never exposes raw credentials to external APIs.

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