# Recruit CRM MCP > Recruit CRM connects your entire recruiting pipeline into your AI agent. It lets you list, track, and manage candidates, job openings, client companies, and key contacts—all from a single chat interface. Stop juggling tabs across multiple systems; get an immediate view of where every applicant stands. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** recruitment, ats, crm, hiring, automation, recruitcrm, ai-agents, mcp ## Description This agent hooks your whole recruiting pipeline right into your AI client. You'll manage candidates, jobs, and client details without jumping between screens. It gives you one central chat interface to track everything—where every applicant stands, what roles are open, and who you gotta call at the company. **Managing Candidates** You can pull up a full list of everyone currently in your system using `list_candidates`. If you need deep background on just one person, running `get_candidate_details` pulls all their specific profile info. You also don't have to manually enter new folks; just call `create_candidate`, and it adds a brand-new record straight into your database. **Tracking Jobs and Openings** To see what roles are active or closed, use `list_jobs` to get the full directory of job vacancies. Need specifics on one posting? `get_job_details` pulls up every comprehensive detail about that existing role. You can also check which candidates applied for a specific opening by running `list_job_applications`. When you're ready to fill a spot, calling `create_job` publishes an entirely new job listing into the system. **Client and Contact Intelligence** You don't want to guess who's who. `get_company_details` fetches all the background info and contact details for any client or hiring company you work with. You can also view your entire roster of partners using `list_companies`, which gives you a directory listing of every client in your database. If you know the company but need to talk to a specific person, use `get_contact_details` to get that individual's direct info. Need to see all key contacts associated with a particular client? Just run `list_contacts`. **System Overview and Setup** This agent handles listing everything—your candidates, your companies, and your jobs—so you only have one place to look. You can pull up basic account info for the connected user by calling `get_me`. This server lets your AI client interact with every core function of your recruiting database, giving you a single source of truth without any messy manual data entry or tab juggling. ## Tools ### create_candidate Adds a new candidate record to your recruitment database. ### create_job Publishes an entirely new job posting into the system's vacancy list. ### get_candidate_details Retrieves all specific information for a single candidate profile. ### get_company_details Fetches complete background and contact details about any client company. ### get_contact_details Gets specific information for a key contact at a given company. ### get_job_details Pulls comprehensive details about an existing job vacancy or role. ### get_me Retrieves basic account information for the connected user. ### list_candidates Generates a full list of all candidates currently stored in your system. ### list_companies Provides a comprehensive directory listing of client companies. ### list_contacts Lists all key contacts associated with the client companies in your database. ### list_job_applications Shows which candidates are currently assigned to a specific job posting. ### list_jobs Displays the full list of all active and past job vacancies. ## Prompt Examples **Prompt:** ``` List all active jobs in Recruit CRM. ``` **Response:** ``` I've found 5 active jobs, including Software Engineer (ID: j1) and Product Manager (ID: j2). ``` **Prompt:** ``` Show me all candidates in the final interview stage across all open positions. ``` **Response:** ``` 14 candidates in final interview stage across 6 open positions. "Senior Backend Engineer": 3 candidates (top: Sarah Chen, 4.8/5 rating). "Product Manager": 2 candidates. "UX Designer": 3 candidates (final decision by Friday). "DevOps Lead": 2 candidates. "Sales Director": 2 candidates. "Data Analyst": 2 candidates. Average time in pipeline: 18 days. 5 candidates have competing offers with deadlines this week. 3 reference checks are pending completion. ``` **Prompt:** ``` Add a new candidate to the Senior Backend Engineer position and schedule a first-round interview. ``` **Response:** ``` Candidate added: Alex Rivera. Position: Senior Backend Engineer. Source: LinkedIn. Resume parsed: 8 years experience, Python/Go/AWS. Skills match: 92%. First-round interview scheduled: Thursday, May 22 at 10 AM with James Park (Engineering Manager). Calendar invite sent to candidate and interviewer. Interview scorecard template "Technical Assessment v3" attached. Candidate status: Active, Stage: Phone Screen. ``` ## Capabilities ### Create Candidate Records Add a new candidate profile, capturing all necessary details for tracking. ### Post New Jobs Generate and publish a brand-new job posting into the system's vacancy list. ### Get Candidate Details Pull all specific information for one candidate using their unique ID or name. ### List All Candidates Retrieve a full, current list of every candidate in the database. ### Get Company Details Fetch all key information about a client or hiring company. ### List Job Vacancies See a comprehensive list of all open and closed job positions. ### Get Contact Details Retrieve specific contact information for an individual at a company. ## Use Cases ### New Client Onboarding A new client signs on. Instead of emailing a request for company data, you ask your agent to run `get_company_details` using the name. The system pulls all relevant history and key contacts (using `list_contacts`), allowing you to start immediately without manual research. ### Candidate Status Audit You need a status report on 5 open positions. You ask the agent to use `list_jobs` for all active roles, and then loop through each job ID using `list_job_applications`. This gathers all necessary candidate data in one automated sequence. ### Rapid Data Capture You get a promising referral. Instead of opening the full form, you tell your agent to use `create_candidate` and paste the details into the chat. It builds the record instantly, saving minutes on every single entry. ### Following Up with Stakeholders A job is open (found using `list_jobs`), but you don't know who to contact at the client company. You ask your agent to run `get_company_details` and then use `list_contacts` on that record, giving you names and direct lines. ## Benefits - Stop manually cross-referencing data. Need to know who applied for a role? Just ask the agent to `list_job_applications` and get the list immediately. No switching tabs. - Data entry is faster than ever. Instead of opening a form, you tell your AI client to use `create_candidate`, giving it all the required data points in one go. - Client background checks are simple. You don't need to jump into Google; asking for `get_company_details` pulls that core info right into your chat window. - See pipeline bottlenecks instantly. Run `list_jobs` and then follow up with a query to see which candidates (`list_job_applications`) are stuck at the screening stage. - Keep contacts organized. You can list all clients using `list_companies`, and immediately drill down to specific people using `get_contact_details`. It keeps your data structured. - Get account context fast. The `get_me` tool ensures your agent always knows which user is performing the action, keeping audit logs clean. ## How It Works The bottom line is, you give your AI client the key, and it uses that key to talk directly to your recruitment database. 1. Obtain your API Token from Recruit CRM (Admin Settings > Account Management). 2. Enter that token into the Vinkius platform integration settings. 3. Start interacting with the Recruit CRM agent chat window to execute commands. ## Frequently Asked Questions **How do I list all active job vacancies using the `list_jobs` tool?** You just ask the agent to run `list_jobs`. The server returns a complete, up-to-date listing of every available vacancy ID and its current status. **Can I add new candidates using `create_candidate` if they aren't in my contact list?** Yes. The `create_candidate` tool lets you build a profile even if the person isn't tied to an existing client record, keeping your recruiting data clean and separate from company contacts. **What is the difference between `list_companies` and `list_contacts`?** `list_companies` gives you a directory of all client organizations. You use `list_contacts` afterward, passing in a company ID to get only the people associated with that specific organization. **If I need details on one job, which tool should I use: `get_job_details` or `list_jobs`?** `list_jobs` gives you a summary list of all jobs. Use `get_job_details` when you already know the Job ID and need every single piece of data about that one specific opening. **Does the agent support creating job postings for multiple roles at once?** No, the `create_job` tool handles one posting per call. You'll have to ask your agent to run the command sequentially for each role you need to publish. **How can I filter or paginate results when using the `list_candidates` tool?** The `list_candidates` tool supports filtering by status (e.g., Active, Interviewing) and allows pagination through offset parameters. You must pass a limit count to retrieve results in manageable batches rather than receiving a massive data dump. **What information does the `list_job_applications` tool provide for a given job ID?** This tool lists every candidate associated with a specific Job ID. Each record includes the Candidate's Name, their current Application Status, and the date they applied to the role. It’s perfect for auditing your pipeline. **Should I use the `get_me` tool to verify API rate limits or user permissions?** The `get_me` tool retrieves basic account information, including your primary credentials and associated email. For specific quota details or hard rate limit numbers, check the full Vinkius documentation linked in the platform settings. **How do I get my API Token?** Log in to Recruit CRM and go to Admin Settings > Account Management > API Token to generate your token.