How to Use the Adzuna MCP in OpenAI Agents SDK

Q: How does OpenAI Agents SDK handle schema validation for Adzuna?

The SDK auto-discovers the schema for getsalaryhistogram and other tools on this MCP Server at startup. It maps the expected arguments directly into the agent's execution context, forcing the model to provide valid search terms and country codes before making the call.

Build production-grade OpenAI Agents SDK systems that query live job markets and track historical salary trends automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Adzuna MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Monitor Salary Trends with OpenAI Agents SDK

Your autonomous agent calls `get_salary_history` using this MCP Server to pull actual wage trajectories directly into the OpenAI Agents SDK runtime. The agent validates this market data against your custom guardrails before executing any downstream recruiting workflows. Because the SDK manages state across specialized runs, your agent compares these historical trends with current live listings without losing context. This keeps your automated hiring pipelines grounded in verified pay scales instead of outdated estimates.

Filter Regional Vacancies Safely

The `search_jobs` tool requires a strict two-letter country code, which your OpenAI Agents SDK agent enforces natively via its built-in input validation. The agent rejects invalid country inputs before hitting the live endpoint, saving API quota and preventing execution failures. Once verified, the agent retrieves active listings matching your exact keyword parameters. The SDK traces these payload transfers on your developer dashboard, giving you a clear audit trail of every job query your system runs.

Map Competitor Hiring Volumes

Your agent invokes `list_top_companies` to identify which employers dominate specific sectors, feeding this competitive intelligence directly into your OpenAI Agents SDK pipeline. This step lets your multi-agent system hand off raw employer lists to a specialized analysis agent. This MCP Server connection operates within a secure V8 sandbox, meaning your agent safely handles high-volume corporate queries. You get clean, structured lists of top-hiring entities without writing custom scrapers or raw HTTP requests.

Setup guide

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

Create your Agent

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

Run the agent

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

The SDK auto-discovers the schema for `get_salary_histogram` and other tools on this MCP Server at startup. It maps the expected arguments directly into the agent's execution context, forcing the model to provide valid search terms and country codes before making the call.

Yes, you control tool exposure during the initialization of the server stream context. By configuring the agent's tool list, you restrict access to sensitive endpoints like `list_top_companies` while keeping search functions open.

You wrap the streamable HTTP connection in an asynchronous context manager. This setup manages connection pooling and automatically tears down idle sockets if a salary query takes longer than your specified timeout.

No, Vinkius manages the underlying credentials for you. Your agent connects using a single endpoint token, removing the need to distribute raw API keys to every client instance.

All search terms, postal codes, and country parameters are processed inside ephemeral V8 isolates that destroy the data immediately after the request completes. Your proprietary hiring queries never persist on disk or train external models.

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