How do I connect my Firefish account?

You need your Firefish Client ID and Secret, which you can find in your CRM under Settings and Integrations. Once you have those, you enter them into Vinkius to establish the connection.

Which AI clients can I use with this MCP?

You can use this MCP with any compatible client, including Claude, Cursor, and Windsurf.

Do I need to host the MCP myself?

No, Vinkius hosts and manages the MCP for you. You just connect your client and start using the capabilities.

Can I add new candidates using my AI agent?

Yes, the create_candidate capability allows your agent to add new candidate records directly to Firefish.

Is my recruitment data secure?

Yes, the connection uses your official Firefish Client ID and Secret to ensure secure, authorized access to your data.

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' capability to retrieve the most recent profile information for any specific candidate ID.

Can I filter jobs by their current status?

Yes! The 'listJobs' capability 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' capability 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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Firefish to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Manage candidates and job vacancies through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through Firefish.

01
Get candidate
Fetch specific details for a single candidate profile.
02
Get company
Retrieve full information about a client company.
03
List candidates
Get a list of all candidates in your Firefish database.
04
List companies
Pull a list of all companies currently in your system.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through Firefish.

05
List contacts
Retrieve a list of contacts associated with your clients.
06
List jobs
Get a list of all active job vacancies.
07
List placements
View all successful job placements recorded in the CRM.
08
Get contact
Get detailed information for a specific contact.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through Firefish.

09
List adverts
List all current job advertisements.
10
Create candidate
Add a new candidate record to Firefish.
11
Get job
Retrieve full metadata for a specific job vacancy.
12
List actions
Get a list of recent recruiter actions and activity logs.

Real work

What teams actually run

Pre-call Briefing

Ask your agent to pull company and contact details right before a client call.

Candidate Sourcing

Tell your agent to find candidates that match specific job requirements.

Performance Reviews

Request a list of recent recruiter actions to evaluate team activity.

Vacancy Management

Check the status of job adverts and active vacancies without opening the CRM.

Automate a task

Put Firefish to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Firefish works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Firefish to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

974ms average. Fast in production.

Firefish is checked daily against the live service.

Daily averagePeak 1266ms

Oct 3Today

Fastest day: 782ms
Slowest day: 1266ms
14-day trend: Improving-13%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Firefish, so you can see the experience inside your AI.

It does not authenticate your account with Firefish. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Firefish Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Firefish capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "firefish-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Firefish in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Firefish owners hand off.

This MCP is designed for recruitment professionals who use Firefish to manage their talent pipelines and client relationships.

01
Recruiters
Pull candidate details or job specs while talking to hiring managers.
02
Talent Acquisition Managers
Get a high level view of active placements and adverts via AI commands.
03
Agency Owners
Automate the retrieval of recruiter activity and company data for reviews.

FAQ

Questions Firefish owners ask.

01
How do I connect my Firefish account?
You need your Firefish Client ID and Secret, which you can find in your CRM under Settings and Integrations. Once you have those, you enter them into Vinkius to establish the connection.
02
Which AI clients can I use with this MCP?
You can use this MCP with any compatible client, including Claude, Cursor, and Windsurf.
03
Do I need to host the MCP myself?
No, Vinkius hosts and manages the MCP for you. You just connect your client and start using the capabilities.
04
Can I add new candidates using my AI agent?
Yes, the create_candidate capability allows your agent to add new candidate records directly to Firefish.
05
Is my recruitment data secure?
Yes, the connection uses your official Firefish Client ID and Secret to ensure secure, authorized access to your data.
06
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' capability to retrieve the most recent profile information for any specific candidate ID.
07
Can I filter jobs by their current status?
Yes! The 'listJobs' capability retrieves all active jobs. You can then ask your AI agent to sort or filter these results based on status, title, or hiring company.
08
What format should I use for creating a new candidate?
Use the 'createCandidate' capability 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.

Explore

More in Human Resources

Connect Firefish to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get candidate

Get company

List candidates

List companies

05-08

List contacts

List jobs

List placements

Get contact

09-12

List adverts

Create candidate

Get job

List actions

What teams actually run

Pre-call Briefing

Candidate Sourcing

Performance Reviews

Vacancy Management

Building your own app? The connector is yours to use.

Firefish Connector

Claude Desktop

Recruiters

Talent Acquisition Managers

Agency Owners

How do I connect my Firefish account?

Which AI clients can I use with this MCP?

Do I need to host the MCP myself?

Can I add new candidates using my AI agent?

Is my recruitment data secure?

How do I ensure the candidate data is up to date?

Can I filter jobs by their current status?

What format should I use for creating a new candidate?

ApplicantStack AI Connector

Greenhouse AI Connector

Breezy HR AI Connector

CATS ATS AI Connector

Suggestions

Workable AI Connector

Workable AI Connector

Crelate Talent CRM AI Connector

RecruSpace AI Connector