How to Use the ZipRecruiter MCP in OpenAI Agents SDK

Q: How do I use ZipRecruiter with OpenAI Agents SDK?

Your agent calls ziprecruitersearchjobs directly. You just pass the keyword, location, and salary details you want it to look for.

Q: If I need job data from ZipRecruiter with OpenAI Agents SDK, what's the best way?

Use ziprecruitersearchjobs. It'll pull structured results based on your input, making it easy for subsequent steps in your agent workflow.

Find high-paying roles immediately with your OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ZipRecruiter MCP to OpenAI Agents SDK

Create your Vinkius account to connect ZipRecruiter to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ZipRecruiter with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run Searches via the MCP Server

Need to find jobs across millions of listings? You can call `ziprecruiter_search_jobs` directly. This tool handles searching ZipRecruiter using keywords, location, and salary criteria. Your agent doesn't waste time on vague results. It sends specific parameters—like 'Senior Python Developer' in 'Austin' earning '$150k+'—and gets back a clean list of potential roles.

Targeted Job Filtering

The `ziprecruiter_search_jobs` tool gives you precise control over the job search. You specify exactly what you're looking for, which cuts down on irrelevant results. It’s about accuracy here. Instead of just getting a general idea of market demand, your agent gets structured data showing where those specific skills and pay grades are currently active.

Systematic Job Discovery

Building a production agent means knowing when to search for talent. The `ziprecruiter_search_jobs` function lets you systematically check different markets or skill sets. You can trigger multiple searches—checking salaries in New York one minute, then pivoting to remote roles the next—all within your automated pipeline.

Setup guide

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

Create your Agent

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

Run the agent

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