# Firefish MCP MCP > 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. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** candidate-management, talent-pools, recruitment-crm, job-posting, applicant-tracking, hiring-workflow ## Description 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. ## Tools ### 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. ### 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. ## Prompt Examples **Prompt:** ``` List all active job vacancies at Firefish. ``` **Response:** ``` Fetching jobs... I found 5 active job vacancies, including 'Senior Software Engineer' and 'Recruitment Consultant'. Would you like the full details for any of these? ``` **Prompt:** ``` Search for a candidate named 'John Smith'. ``` **Response:** ``` Searching candidates... I found a profile for John Smith (ID: cand_456) with status 'Active'. He is currently listed as a 'Project Manager'. ``` **Prompt:** ``` Show me the most recent recruiter actions. ``` **Response:** ``` Retrieving actions... Here are the latest actions recorded, including 'Email Sent to Candidate cand_123' and 'Interview Scheduled for Job job_789'. ``` ## Capabilities ### Create New Candidates Instantly generate a new candidate record in the system. ### Retrieve Candidate Details Pull up all historical and current information on any specific applicant. ### Get Company Data Fetch background details on client or potential partner companies. ### Get Contact Information Retrieve specific contact records, like phone numbers and job titles. ### View Job Specs Access the full metadata for any active or past job vacancy. ### List All Placements Get a summary list of successful placements and overall recruitment progress. ## Use Cases ### 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. ## Benefits - 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. ## How It Works The bottom line is you talk to your agent, and it pulls the data directly from Firefish. 1. Subscribe to this MCP through the Vinkius Marketplace. 2. Enter your Firefish Client ID and Secret (you find these in your Firefish settings). 3. Ask your AI client to perform a task, like 'List all active job vacancies' or 'Get details for candidate John Smith'. ## Frequently Asked Questions **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.