Firefish Connector for AI agents.

Q: 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.

Q: 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.

12 live capabilities

Manage your recruitment CRM and candidate pipeline through natural conversation.

Live agent request Firefish / Connector

Waiting for input…

AI Agent

Why people use Firefish

Firefish for Faster Candidate Sourcing

With this Connector, you just ask your agent. You can pull a candidate profile or list active jobs in seconds. You get the info you need exactly when you need it, without the tab-switching headache.

What Vinkius changes

You get a conversational interface for your entire recruitment CRM.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Live candidate screening

A headhunter is on a call and needs to know a candidate's status.
Real-world use case 02

Weekly agency performance review

An agency owner needs to review team activity.
Real-world use case 03

Rapid job vacancy overview

A recruiter needs to see all open roles.

Complete set · 12capabilities

The complete Firefish capability set.

These are the exact actions your AI can choose when you ask it to work with Firefish.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 12 available through Firefish.

01 Capability
Create candidate
Create a new candidate record in your CRM. This helps you keep your talent pool updated without manual entry.
02 Capability
Get candidate
Get specific details for a single candidate profile. Use this to quickly review a person's history during a call.
03 Capability
Get company
Pull details for a specific client company. This is great for researching a client before a meeting.
04 Capability
Get job
Retrieve complete metadata for a specific job vacancy. Use this to see the full scope of an open role.

Capability set02 / 03

05—08

4 capabilities in this set.

Part of 12 available through Firefish.

05 Capability
List actions
List the most recent actions taken by your recruiters. This provides a clear audit trail of your team's work.
06 Capability
List candidates
List all candidates currently in your talent pool. Use this to see the full scope of your available talent.
07 Capability
List companies
List all companies in your database. This gives you a quick overview of your current client base.
08 Capability
List contacts
List all contacts associated with your accounts. This helps you manage your network of stakeholders.

Capability set03 / 03

09—12

4 capabilities in this set.

Part of 12 available through Firefish.

09 Capability
List jobs
List all active job vacancies. Use this to see every open role your agency is currently managing.
10 Capability
List placements
List successful job placements across your team. This is perfect for tracking your agency's wins.
11 Capability
Get contact
Get the contact information for a specific lead or client. It saves you from hunting through old emails.
12 Capability
List adverts
List all active job advertisements in your system. This helps you see where your reach is currently focused.

Set up in minutes

One URL. Then ask Firefish to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Firefish from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Firefish, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Firefish for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Firefish URL.
Step 03

Save and start

Save the connection and enable Firefish in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

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

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Firefish

Open Agent mode in chat and ask: "Using Firefish, help me...". 12 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

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

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Firefish

Ask Copilot: "Using Firefish, help me...". 12 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

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

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Firefish

Open Cascade and ask: "Using Firefish, help me...". 12 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

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

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Firefish

Ask Cline: "Using Firefish, help me...". 12 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add firefish --transport http "https://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Firefish

Ask Claude: "Using Firefish, show me...". 12 tools are ready

Where the request belongs

Work Firefish can move forward.

Built around the request

Recruiters who are tired of clicking through dozens of tabs to find one candidate profile or job spec. It's for the headhunter who needs to keep their talent pipeline moving without the administrative overhead of manual CRM updates.

Headhunter

Pulling candidate details during live calls with hiring managers to provide instant updates.

Talent Acquisition Manager

Getting a bird's-eye view of active placements and job ads to report on team progress.

Recruitment Agency Owner

Auditing recruiter actions and company data for performance reviews and agency growth.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Breezy HR

Manage your recruitment process via Breezy HR. track candidates, positions, and stages directly from any AI agent.

View Connector

02 10 capabilities

Crelate Talent CRM

Equip your AI agent to manage candidates, jobs, and client companies directly via the Crelate API.

View Connector

03 12 capabilities

Greenhouse

Manage your recruiting pipeline via Greenhouse. list candidates, track applications, and audit jobs directly via AI.

View Connector

04 12 capabilities

Recruit CRM

Manage candidates, jobs, and client companies with Recruit CRM and AI agents.

View Connector

05 12 capabilities

Gem

Manage recruitment CRM pipelines, track candidates, and oversee outreach via AI agents with Gem.

View Connector

06 12 capabilities

Wizehire

Manage candidates, job postings, and hiring stages via Wizehire directly from your AI agent.

View Connector

Bring your own AI

Change the model, client or framework. Keep Firefish connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Firefish.

The practical details behind the request, access and result.

Can Firefish MCP help me manage my talent pool?

Yes, it lets you list and get details for all your candidates directly through your AI client, making it much faster to browse your talent pool.

How does Firefish MCP work with my AI client?

You connect your Firefish API keys, and your agent can then read and write to your CRM. This allows you to manage your data using natural language.

Can I use Firefish MCP to see our job ads?

Yes, it can list all active advertisements to show where you're currently advertising, helping you monitor your recruitment reach.

Does Firefish MCP support multi-user actions?

It can list actions taken by your recruiters, which is perfect for getting a clear view of your team's activity and engagement.

Can I add new candidates using Firefish MCP?

Yes, you can use it to create new candidate records directly through your agent, which saves you from having to manually type in new data.

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

The Firefish Connector 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.

One connection away

Give your agent a direct line to Firefish.

Connect Firefish once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Firefish for Faster Candidate Sourcing

You get a conversational interface for your entire recruitment CRM.

Live candidate screening

Weekly agency performance review

Rapid job vacancy overview

Create candidate

Get candidate

Get company

Get job

List actions

List candidates

List companies

List contacts

List jobs

List placements

Get contact

List adverts

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Firefish

Create MCP config

Add the server config

Enable Agent mode

Start using Firefish

Open MCP Settings

Add the server

Save and reload

Start using Firefish

Open Cline MCP Settings

Add remote server

Enable the server

Start using Firefish

Install Claude Code

Add the Connector

Verify the connection

Start using Firefish

Headhunter

Talent Acquisition Manager

Recruitment Agency Owner

Breezy HR

Crelate Talent CRM

Greenhouse

Recruit CRM

Gem

Wizehire

Give your agent a direct line to Firefish.