How to Use the Jobtoolz MCP in OpenAI Agents SDK

Build production-ready recruitment pipelines with OpenAI Agents SDK using direct access to your Jobtoolz candidate data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Jobtoolz MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate applicant screening with OpenAI Agents SDK

This MCP Server connects your autonomous agent directly to candidate profiles via `get_candidate`. Your agent pulls contact info, application histories, and custom fields to verify if an applicant fits the target profile without you clicking through a browser. It gets the raw data directly, making decisions based on actual facts rather than guesses. You can chain this tool with `list_candidates` to run batch screening sessions. The agent loops through new entries, flags promising profiles, and keeps your pipeline moving without manual intervention.

Audit hiring sources and department pipelines

This MCP Server exposes `list_sources` and `list_departments` to help you track where your best applicants originate. Your agent runs queries across these endpoints to compile reports on channel performance. You see exactly which job boards bring in top talent. Combine this with `list_jobs` to map open positions back to specific teams. It gives your agent the context it needs to organize candidates by business unit automatically.

Map candidate journeys through pipeline stages

This MCP Server exposes `list_stages` and `list_tags` to give your agent a clear map of your hiring workflow. The agent checks these endpoints to find out exactly where a candidate sits in the hiring funnel. It prevents your system from sending the wrong email to someone who already reached the offer stage. Use `list_users` alongside these tools to assign hiring managers to specific stages. Your agent handles the routing so your team only sees candidates who passed initial screens.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the library via pip and initialize the MCP server streamable HTTP class with your Vinkius endpoint. Pass this server instance into your Agent constructor's server list. The SDK automatically discovers all 10 recruitment tools at runtime.

Yes, you can control tool access directly in your agent configuration. While the server exposes all tools like `get_job` and `list_candidates`, your agent setup can restrict execution permissions. This keeps sensitive operations isolated to specific agents.

Yes, it works perfectly with agent handoffs. You can have a specialized screening agent use `get_candidate` to pull initial application details and then hand off the task to a scheduling agent. The second agent then uses `list_users` to find the correct hiring manager for the next step.

The SDK relies on your client-side error handling and backoff strategies when hitting the API. If tool calls like `list_jobs` return limit errors, your agent code must catch these and retry. Vinkius manages the underlying connection stability to keep things running.

Your candidate profiles and hiring histories are processed in an isolated V8 sandbox. Vinkius uses ephemeral execution environments that destroy your session data as soon as the tool call completes. No recruitment data 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