Supercharge your AI with Firefish. Automate your entire recruitment data flow.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Firefish lets you manage every part of the hiring process—from finding candidates to tracking placements. Connect your Firefish account via Model Context Protocol (MCP) to automate data retrieval and record creation using natural conversation with any AI client.
What your AI can do
Create candidate
Creates a new candidate record in the Firefish system.
Get candidate
Retrieves all specific details for one candidate profile.
Get company
Fetches detailed information about a company.
Instantly generate a new candidate record in the system.
Pull up all historical and current information on any specific applicant.
Fetch background details on client or potential partner companies.
Retrieve specific contact records, like phone numbers and job titles.
Access the full metadata for any active or past job vacancy.
Get a summary list of successful placements and overall recruitment progress.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Firefish: 12 Tools for Recruitment
You can use these tools to list, get, or create records for every key entity in your recruitment workflow: candidates, jobs, companies, and contacts.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Firefish on VinkiusCreate Candidate
Creates a new candidate record in the Firefish system.
Get Candidate
Retrieves all specific details for one candidate profile.
Get Company
Fetches detailed information about a company.
Get Contact
Gets the contact details, like phone number or email, for a specific person.
Get Job
Retrieves the complete metadata and description for a job vacancy.
List Actions
Lists recent actions taken by recruiters, maintaining an audit trail.
List Adverts
Retrieves a list of all active job advertisements currently running.
List Candidates
Pulls a summary list of every candidate in the database.
List Companies
Lists all client and partner companies stored in your system.
List Contacts
Provides a list of all individual contacts associated with the firm.
List Jobs
Lists all existing job vacancies currently tracked in your system.
List Placements
Generates a summary list of successful placements and their status.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token from
cloud.vinkius.com. For OAuth-protected servers, expand Advanced
settings to add credentials.
Start a conversation
Open a new chat. The Firefish integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Firefish, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The pain of switching screens for simple research
Right now, figuring out a lead's background requires constant context switching. You find a name, you copy it into the search bar, then hit enter. If you need company info too, you have to open another tab and repeat the process. It’s a tedious loop of clicking through records and jumping between tabs just to get one cohesive picture.
With this MCP, that friction disappears. You speak your requirements to your agent—'What do I know about John Smith?'- The system handles all the internal API calls; it pulls candidate details, checks company info, and gives you a single answer. It’s instant context.
Using Firefish MCP for Data Management
Manual data management means tracking placement records in one place while listing active jobs in another, leading to stale or contradictory information. You waste time verifying if a candidate listed profile matches the job specs.
The MCP lets you manage all these elements together. You can list candidates and instantly pull up associated job details using `get_job` or even create new records with `create_candidate`, ensuring your data stays accurate and connected.
What your AI can actually do with this
Running a recruitment agency means juggling candidate profiles, job listings, company details, and placement statuses. This MCP connects all that information into one place for your agent. Instead of jumping between tabs or manually logging data points, you just talk to your AI client. You can ask it to pull up every detail on a promising lead, cross-reference their background with active jobs, or even draft a new candidate record from scratch.
It's like having your entire CRM open and ready to go, controlled by simple conversation. By connecting through Vinkius, you get access to this Firefish data alongside thousands of other tools, keeping all your operational systems talking to each other.
019d7599-b48a-7296-bf0f-fe75e60355f6 
Here's how it actually works
The bottom line is you talk to your agent, and it pulls the data directly from Firefish.
Subscribe to this MCP through the Vinkius Marketplace.
Enter your Firefish Client ID and Secret (you find these in your Firefish settings).
Ask your AI client to perform a task, like 'List all active job vacancies' or 'Get details for candidate John Smith'.
Who is this actually for?
Recruitment Agency Owners who spend too much time manually compiling reports. Headhunters who need instant candidate background checks before a meeting. Talent Acquisition Managers tired of losing context across multiple spreadsheets.
Pulls up detailed profiles for candidates and cross-references them against company data right before an interview call.
Automates the retrieval of recent recruiter actions and company performance metrics to generate quick reports.
Gets a bird's-eye view of active placements, job adverts, and overall pipeline health using simple commands.
What Changes When You Connect
Stop manual lookups. Instead of digging through multiple tabs to find a candidate's history, simply ask the agent to 'get candidate details,' and all that information is pulled instantly.
Improve vetting speed. Before a meeting, use the MCP to pull both company data and contact details simultaneously, giving you immediate background context on your call list.
Keep track of progress without logging in. You can tell your agent to 'list placements' or 'list jobs,' getting an instant status report on where every deal stands.
Build profiles faster. Need a new lead? Use the MCP to generate a candidate record and populate it with key details right from your conversation.
Audit everything instantly. If you forget who did what, asking the agent to 'list actions' keeps a clear, searchable log of recent team activity.
See it in action
The Pre-Meeting Prep
A headhunter has an important call with a client. Instead of opening the CRM and manually checking multiple tabs for company info, they ask their agent to 'get company' details plus 'list contacts.' The agent returns all necessary background data in one go.
The Pipeline Review
A TA Manager needs a quick status update. They prompt the agent to 'list placements' and 'list jobs,' immediately seeing which roles are filled and where the biggest bottlenecks exist without opening any dashboards.
New Candidate Onboarding
A recruiter finds a great cold lead. Rather than copying data into a form, they prompt the agent to 'create candidate,' providing key details conversationally. The new record is created and filled out immediately.
Tracking Activity for Review
An agency owner needs to review team output. They ask the agent to 'list actions' over the last week, getting a comprehensive list of every email sent or interview scheduled by any team member.
The honest tradeoffs
Jumping between tabs
A recruiter needs company data and candidate history. They open the CRM, navigate to 'Company,' copy the name, then switch to 'Candidates' and paste it in—a process that takes minutes.
Just ask your agent: 'Get company details for Acme Corp and list candidates who worked there.' The MCP handles the cross-reference in one prompt.
Manual data entry
You find a promising lead via LinkedIn. You open Firefish, navigate to 'New Candidate,' and manually type out all their job titles and contacts.
Use the MCP's create candidate tool. Provide the raw information to your agent and let it handle formatting and writing the record for you.
Confusing data sources
You need to know if a contact is connected to a job or just listed generally, forcing you to check multiple reports.
Use the MCP's get_contact tool. Specify who you need details for, and it pulls all relevant associated records in one call.
When It Fits, When It Doesn't
You should use this MCP if your pain point involves coordinating data across multiple modules: candidates, jobs, companies, and contacts. If you are constantly asking yourself, 'Where is that information located?' or 'How do I link these two pieces of data?' then this connector is for you. Don't use it if you only need to view a single list (like just listing ads); those basic views might be fine without the full MCP setup. However, if your workflow requires reading data from one place and writing related data to another—for instance, creating a candidate record based on retrieved company info—this is necessary.
Questions you might have
How do I ensure the candidate data is up to date? +
The Firefish MCP server fetches data directly from your live Firefish environment. Use the 'getCandidate' tool to retrieve the most recent profile information for any specific candidate ID.
Can I filter jobs by their current status? +
Yes! The 'listJobs' tool retrieves all active jobs. You can then ask your AI agent to sort or filter these results based on status, title, or hiring company.
What format should I use for creating a new candidate? +
Use the 'createCandidate' tool by providing the first name, last name, and email address. The agent will handle the underlying API request to ensure the record is created correctly in Firefish.
If I use the `get_candidate` tool with an invalid or deleted ID, what error does my agent client receive? +
It returns a specific 404 Not Found status. Your AI client will confirm that the candidate record doesn't exist and prompt you to check your ID against list_candidates first.
Are there rate limits if I run multiple list commands, like using `list_companies` repeatedly? +
Yes, Vinkius manages standard API rate limiting. If you hit the limit, your agent client receives a retry message and automatically waits before attempting the call again. You won't lose data.
When I use the `list_actions` tool, how do I filter the results to only show activity from last week? +
You must provide specific start and end timestamps in your prompt context. The system then filters the audit trail data accordingly, giving you a precise view of engagement.
How can I link contacts? If I use `get_company`, how do I find all associated people? +
You must first retrieve the unique Company ID using get_company. Then, pass that specific ID to your agent when calling tools like list_contacts for accurate filtering.
What happens if my Firefish Client ID or Secret credentials expire or change? +
You need to manually re-enter the current Client ID and Secret into Vinkius. The connection will fail until you provide these updated, valid credentials in your settings.
We've already built the connector for Firefish. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.