# Jobtoolz MCP > Jobtoolz provides a full API connection to recruitment management data. Use this MCP to automate candidate tracking, view open positions, and map out your entire hiring pipeline programmatically. Need to check applicant status or cross-reference job details? This tool handles it all. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** recruitment, candidate-pipeline, hiring-automation, job-posting, talent-management ## Description This connector lets your agent manage the messy parts of recruiting. Instead of juggling spreadsheets and logging into multiple tabs just to track a candidate's movement, you get direct access to core recruitment data. You can list every open position, pull up a candidate’s entire application history, or check which department they belong to—all through simple API calls. If your job is automating the hiring funnel, this MCP has what you need. By connecting Jobtoolz via Vinkius, you give your AI client the ability to treat raw recruitment data like it's part of its natural knowledge base. You can audit everything from how a candidate arrived (the source) to which stage they are currently in. It turns complex HR workflows into simple commands for your agent. ## Tools ### get_candidate Pulls deep data on one applicant, including their contact info and full application record. ### get_job Retrieves all requirements and status information for a single job opening. ### list_candidates Generates an overview list of every candidate in the system, showing their ID and current pipeline stage. ### list_departments Provides a comprehensive list of all departments used within your organization's structure. ### list_jobs Lists every currently active job opening, including the title and which department it belongs to. ### list_locations Returns a list of all office locations where jobs are open. ### list_sources Lists all ways candidates entered the system (e.g., Indeed, Company Website) for auditing purposes. ### list_stages Shows every configured stage in your hiring workflow (Applied, Interview, Offer). ### list_tags Lists all custom tags used to categorize or filter candidate records. ### list_users Retrieves a list of internal users, such as administrators or hiring managers. ## Prompt Examples **Prompt:** ``` List all open jobs in Jobtoolz. ``` **Response:** ``` I'll fetch the list of active job openings from your Jobtoolz account. ``` **Prompt:** ``` Show me the details for candidate ID '123'. ``` **Response:** ``` I'll retrieve the full profile and status for that specific candidate from Jobtoolz. ``` **Prompt:** ``` Check the available recruitment sources. ``` **Response:** ``` I'll look up the list of configured recruitment sources in your Jobtoolz account. ``` ## Capabilities ### Look Up Specific Candidate Profiles Retrieve full details, contact info, and the complete history of any single applicant. ### Analyze Job Requirements Get detailed descriptions, necessary qualifications, and internal status for a specific job role. ### Map Out Applicant Flow Pull lists of all candidates currently in the system to monitor overall applicant volume and status. ### Audit Business Structure List departments, locations, or recruitment sources to filter data by business unit or geography. ### Check Pipeline Statuses Get all configured pipeline stages and tags so your agent knows the official hiring process steps. ## Use Cases ### Auditing a specific hiring channel A recruiter needs to know if their company website or Indeed has been the primary source of leads this quarter. The agent uses `list_sources` to pull all origins, allowing the user to immediately filter and review only candidates from the desired location. ### Finding roles for a new department A hiring manager wants to see what open positions exist in R&D but not Sales. They ask the agent to combine `list_departments` with `list_jobs`, generating a precise list of job IDs they can then use to pull candidate requirements. ### Reviewing an applicant's full history A team member needs to vet Candidate ID 'XYZ'. They ask the agent to run `get_candidate` and get a full report, including their contact details and every job they applied for in the past. ### Cross-referencing candidate tags The TA specialist needs all candidates who are marked 'Senior' and whose current status is 'Interview'. The agent uses `list_tags` to confirm valid tags, then runs a combined search on the candidate list. ## Benefits - Stop manually checking statuses. Using `list_candidates` lets your agent monitor the entire applicant pool, so you always know who's where in the pipeline. - No more guessing about roles. You can check a specific role’s details using `get_job`, ensuring your AI client has all mandatory requirements before drafting job descriptions. - Audit hiring effectiveness instantly. Pulling data from `list_sources` tells you exactly which channels bring in the most qualified leads, saving time on marketing spend. - Filter candidates accurately by business unit or geography using `list_departments` and `list_locations`. This narrows down your search results to only relevant talent pools. - Understand process bottlenecks. By checking all configured stages with `list_stages`, you can spot if the 'Interview' phase is slowing everything down. ## How It Works The bottom line is that it gives your AI client a structured way to ask the hiring platform for specific information without needing to write any complicated code. 1. Your agent determines it needs data, for instance, a list of active roles. 2. It calls the appropriate tool (like `list_jobs`), which sends a request to Jobtoolz's API endpoint. 3. The MCP receives structured JSON data containing job titles, IDs, and departments, which your agent then uses. ## Frequently Asked Questions **How do I use `list_jobs` to see all open positions?** `list_jobs` provides a list of every active job opening, including the title and department ID. This is your starting point for finding what roles are available right now. **What does `get_candidate` do?** `get_candidate` retrieves a deep profile for one person. It pulls contact details, application history, and any custom fields attached to their record. **How can I audit where candidates came from using Jobtoolz MCP?** Use the `list_sources` tool. This lists every recruitment source configured in your account—like 'Indeed' or 'Company Website'—so you know where to focus your marketing efforts. **I need to find all jobs for a specific location; what should I use?** Run `list_locations` first to confirm the exact ID. Then, you can cross-reference that list against `list_jobs` to filter only those roles open at your desired office. **How do I check what stages are in my company's hiring pipeline using `list_stages`?** `list_stages` returns all configured pipeline steps. This lets you see the full flow, like 'Applied,' 'Interview,' or 'Offer.' Use this to map out your entire company hiring process before automating workflows. **If I need to know which hiring managers are set up, how do I use the `list_users` tool?** `list_users` gives you a list of all organization accounts. You can check who the admins or specific hiring managers are, which is essential for managing permissions and knowing who owns what data. **What data does the `get_job` tool return that helps me analyze specific job needs?** `get_job` retrieves much more than just a title. It provides detailed descriptions, required qualifications, and internal status markers for deep analysis of any single role. **I need to filter candidates or jobs by business area; how do I use `list_departments`?** `list_departments` retrieves all available departments (like Sales or R&D). This is necessary if you want to narrow down your search results and focus only on records associated with a specific business unit. **How do I get Jobtoolz API credentials?** Log in to your Jobtoolz account, navigate to Settings > API, and find your API Key. **Does it support departments and locations?** Yes, you can list all configured departments and office locations using this MCP. **Can I see pipeline stages?** Yes, the list_stages tool provides access to your recruitment pipeline configuration.