# Firefish MCP for AI Agents AI Agent Connect > Firefish MCP lets you manage your recruitment CRM data through natural conversation. It connects your Firefish account to your AI client so you can handle candidates, job postings, and company info without switching tabs. It's built for agencies that need to move faster on placements and keep their talent pipelines organized. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_sNdFZtJk5wG6BSxP4JBHt2jgjjLClSTuAzRDz8jh/ai-agent-connect - **Tags:** candidate-management, talent-pools, recruitment-crm, job-posting, applicant-tracking, hiring-workflow ## Description Firefish lets you manage your recruitment CRM data through natural conversation. This Connector connects your account to any AI client, letting you talk to your recruitment data instead of digging through menus. You can manage your entire pipeline, from listing active job vacancies to pulling detailed candidate profiles, just by asking your agent for the info. It's a massive time saver for headhunters who need to stay on top of recruiter actions and placement progress without manual data entry. When you use this through the Vinkius catalog, you're essentially giving your AI a direct line into your agency's brain. You can quickly check company insights before a call or see where your job ads are actually performing. It turns your CRM into a conversational workspace where you can manage your talent pool and job tracking in real-time. ## Tools ### create_candidate Create a new candidate record in your CRM. This helps you keep your talent pool updated without manual entry. ### get_candidate Get specific details for a single candidate profile. Use this to quickly review a person's history during a call. ### get_company Pull details for a specific client company. This is great for researching a client before a meeting. ### get_job Retrieve complete metadata for a specific job vacancy. Use this to see the full scope of an open role. ### list_actions List the most recent actions taken by your recruiters. This provides a clear audit trail of your team's work. ### list_candidates List all candidates currently in your talent pool. Use this to see the full scope of your available talent. ### list_companies List all companies in your database. This gives you a quick overview of your current client base. ### list_contacts List all contacts associated with your accounts. This helps you manage your network of stakeholders. ### list_jobs List all active job vacancies. Use this to see every open role your agency is currently managing. ### list_placements List successful job placements across your team. This is perfect for tracking your agency's wins. ### get_contact Get the contact information for a specific lead or client. It saves you from hunting through old emails. ### list_adverts List all active job advertisements in your system. This helps you see where your reach is currently focused. ## Prompt Examples **Prompt:** ``` What's the status of our current job vacancies? ``` **Response:** ``` ### Active Job Vacancies | Job Title | Status | ID | | :--- | :--- | :--- | | Senior Software Engineer | Open | job_789 | | Recruitment Consultant | Filled | job_456 | | Project Manager | Open | job_123 | I found 3 active openings. Would you like the full details for any of these? ``` **Prompt:** ``` Find the profile for John Smith. ``` **Response:** ``` **Candidate Profile: John Smith** * **Status:** Active * **Current Role:** Project Manager * **ID:** cand_456 * **Last Updated:** July 10, 2026 He is currently listed as a 'Project Manager'. Do you want to see his contact details? ``` **Prompt:** ``` Show me what the team has been doing lately. ``` **Response:** ``` ### Recent Recruiter Activity * **Email Sent** to Candidate `cand_123` (2 hours ago) * **Interview Scheduled** for Job `job_789` (4 hours ago) * **Profile Updated** for Candidate `cand_999` (6 hours ago) These are the latest actions recorded in the CRM. ``` ## Capabilities ### Create candidate records Add new candidates to your database with a single command. ### Fetch candidate profiles Get all the details on a specific person in your talent pool. ### Pull job metadata Retrieve the full specs and status for any open vacancy. ### Access company insights Look up client company data and contact details quickly. ### Track successful placements See which jobs were filled and the progress of your team. ### Monitor job advertisements View your active ads to see where your recruitment efforts land. ### Audit recruiter actions Check the recent activity logs of your recruitment team. ## Use Cases ### Live candidate screening A headhunter is on a call and needs to know a candidate's status. They ask the agent to pull the profile, getting the info in seconds without leaving the call. ### Weekly agency performance review An agency owner needs to review team activity. They ask the agent to list recent actions to see a summary of recruiter engagement for the week. ### Rapid job vacancy overview A recruiter needs to see all open roles. They ask the agent to list all active jobs to see every vacancy in the CRM at once. ### Ad spend analysis A manager wants to see where they are spending ad money. They ask the agent to list active advertisements to see postings across different platforms. ## Benefits - Stop manual data entry by using create_candidate to add new people to your pipeline instantly. - Get instant candidate details with get_candidate while you're on a live call with a hiring manager. - Keep your team's progress visible by using list_placements to track successful hires across the agency. - Stay informed on client needs by pulling company details with get_company before every meeting. - Audit your team's performance by using list_actions to see exactly what your recruiters are doing. - Monitor your reach with list_adverts to see where your job postings are currently active. ## How It Works The bottom line is you get a conversational interface for your entire recruitment CRM. 1. Subscribe to the Firefish MCP on the Vinkius Marketplace. 2. Enter your Firefish Client ID and Secret from your Settings > Integrations page. 3. Start asking your AI client to pull candidate details or list jobs. ## Frequently Asked Questions **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' 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.