How to Use the Wizehire MCP in OpenAI Agents SDK

Q: How do I list job postings with Wizehire and OpenAI Agents SDK?

You simply run the listactivejobpostings tool. The agent pulls a full list of all current openings, so you always know what jobs are live in Wizehire.

Q: Can I check user details using Wizehire and OpenAI Agents SDK?

Yes. You can call getcurrentuser to pull up the profile of the person who is running your agent. It's useful for keeping track of permissions within Wizehire.

Q: How does Wizehire handle webhook tracking with OpenAI Agents SDK?

You monitor system connectivity using listconfiguredwebhooks. This shows you every active hook set up in Wizehire. It's critical for ensuring your automated workflows stay connected.

Q: What data types can I fetch with Wizehire and OpenAI Agents SDK?

You can get specific job details by calling getjobdetails. This returns everything you need about a particular role, like the description or required skills.

Manage your entire recruiting pipeline with Wizehire, built for OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Wizehire MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Update candidate progress instantly

Need to move a person from 'Screening' to 'Interview'? You just call `update_candidate_hiring_stage`. It handles the internal state change for that individual right away. This isn't guessing. This tool actually manages candidates, job postings, and hiring stages via Wizehire directly through your agent.

List all active jobs or people

Want a quick overview of what you're working on? Use `list_active_job_postings` to see every open role, or run `list_candidates` to get a roster of everyone in the system. You can also check who's running the show by calling `list_hiring_team`. It pulls names and roles straight from Wizehire.

Build profiles for new hires

When you find a great person, don't wait until they send an email. You can manually add them using `create_new_candidate`, just supplying their name and email. For existing talent, use `get_candidate_details` to pull up all the history on one specific candidate.

Setup guide

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

Create your Agent

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

Run the agent

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

You simply run the `list_active_job_postings` tool. The agent pulls a full list of all current openings, so you always know what jobs are live in Wizehire.

Yes. You can call `get_current_user` to pull up the profile of the person who is running your agent. It's useful for keeping track of permissions within Wizehire.

You monitor system connectivity using `list_configured_webhooks`. This shows you every active hook set up in Wizehire. It's critical for ensuring your automated workflows stay connected.

You can get specific job details by calling `get_job_details`. This returns everything you need about a particular role, like the description or required skills.

The server touches candidate records (names and emails). Your agent interacts directly via API calls, so you maintain control over which specific candidates' data are accessed and what actions are taken in Wizehire.

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