How to Use the JobScore MCP in OpenAI Agents SDK

Plug your OpenAI Agents SDK directly into your ATS to automate candidate updates and job tracking with production-grade safety.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JobScore MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated candidate pipeline management

Your agent pulls real-time applicant data using `list_candidates` to track progress through your hiring stages. It identifies exactly where each person sits in the funnel without manual spreadsheet exports. Once the agent identifies a candidate, it calls `get_candidate` to pull their full history. This gives your agent the context needed to summarize profiles before you step into an interview.

Sync hiring operations via MCP Server

This MCP Server maps your open roles directly to your agent's decision-making logic. By running `list_jobs`, the agent maintains an accurate count of active positions and their specific department requirements. It handles the heavy lifting of cross-referencing hiring teams. The agent uses `list_hiring_teams` to verify who owns a specific role, ensuring every message or action is routed to the right person.

Verified identity and connection status

Before the agent performs any write operations, it checks its own access levels using `get_me`. This ensures the agent is authenticated and operating within the correct account scope. It provides a clear audit trail of every interaction. Because it leverages the server's tools, your agent maintains a strict record of which user initiated a request, keeping your hiring data clean and traceable.

Setup guide

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

Create your Agent

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

Run the agent

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

The server handles all auth via your endpoint token, keeping your credentials out of the agent code. You define guardrails in your agent to validate every tool output before it touches your database.

Yes. Your agent uses the toolset to look up job IDs and candidate statuses, then decides the next step in your hiring process based on that live data.

It does. You connect the server and the agent handles the async calls natively, keeping your event loop responsive while fetching candidate profiles.

The server returns a standard error code. You should implement a retry strategy or a circuit breaker in your agent logic to manage the flow.

It retrieves contact history, resume highlights, and current application stages. All data is fetched in real-time and remains ephemeral within your agent's session memory.

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