How to Use the Firefish MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK handle large Firefish lists?

Yes. The server supports pagination for listcandidates and listjobs. You won't hit memory limits because the agent pulls data in manageable chunks.

Build production-grade recruitment agents with OpenAI Agents SDK and Firefish.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Firefish MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated candidate sourcing for OpenAI Agents SDK

Stop manual screening by letting your agent query the database directly. Use `list_candidates` to surface talent based on specific criteria without leaving your IDE. Your agent parses the records and prepares a shortlist instantly. It’s faster than any manual search in the recruitment portal.

Real-time job tracking and management

Keep your pipeline moving by syncing active roles with your agent. The `list_jobs` tool pulls open positions into your context window for immediate analysis. Once the agent has the data, it uses `get_job` to fetch granular requirements. You get a clear view of what needs filling without jumping between browser tabs.

Direct record manipulation for Firefish MCP Server

Create new entries directly from your agent's decision logic. The `create_candidate` tool ensures that new talent is added to the system as soon as it's identified. This keeps your database current without human intervention. Your agent maintains the records while you focus on high-level placement strategy.

Setup guide

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

Create your Agent

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

Run the agent

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

All traffic is encrypted and handled through your Vinkius endpoint. You control the scope of the MCP Server access by defining agent permissions.

Yes. The server supports pagination for `list_candidates` and `list_jobs`. You won't hit memory limits because the agent pulls data in manageable chunks.

Absolutely. You can implement validation logic that checks the output of `get_candidate` before the agent takes any further action.

You provide a single endpoint token during the server initialization. This token manages all your connections to the recruitment CRM.

The server manages the connection and implements standard retry logic. Your agent won't crash when it encounters high traffic.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python