# Workable MCP > Workable MCP gives your AI agent full visibility into your applicant tracking system. It lets you manage the entire hiring flow—from listing open jobs to inspecting candidate profiles and registering new talent—all through natural conversation. Stop clicking dashboards; start asking questions. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** applicant-tracking, hiring-workflow, candidate-screening, job-board-integration, recruitment-automation, talent-acquisition ## Description This MCP connects directly to your Workable recruiting account, turning complex HR workflows into simple conversations with your AI agent. You can ask about job openings, get a list of all current candidates across multiple roles, or pull up the full background for any specific person in your pipeline. Need to add someone new? Just tell your agent and it registers them automatically. It also helps you keep track of who's on your internal team by listing account members and linked services. If you’re using other AI tools, remember that Vinkius hosts this MCP, giving your client one place to access powerful recruiting functions without juggling multiple connections. ## Tools ### create_candidate Registers a new person directly into an open job slot. ### get_candidate_profile Retrieves the detailed history, experience, and current status for one specific candidate. ### get_job_details Pulls all necessary information about a single job opening, like its full description or requirements. ### list_linked_accounts Shows which external accounts are connected to your Workable instance. ### list_all_candidates Provides a comprehensive list of every candidate currently in the hiring system. ### list_jobs Lists all job openings, both active and archived, for quick review. ### list_account_members Retrieves a list of people who are part of your internal hiring team. ## Prompt Examples **Prompt:** ``` List all active job openings in our Workable account. ``` **Response:** ``` I've retrieved your active jobs. You have 4 openings: 'Senior Frontend Engineer', 'Product Designer', 'DevOps Specialist', and 'Marketing Lead'. Which one would you like to see the details for? ``` **Prompt:** ``` Show me the details for the candidate 'John Smith'. ``` **Response:** ``` I've fetched John Smith's profile. He is currently in the 'Interview' stage for the 'Senior Frontend Engineer' role. He has 8 years of experience and is marked as 'Highly Recommended'. ``` **Prompt:** ``` Add 'Jane Doe' (jane.doe@example.com) as a candidate for the job 'ENG-101'. ``` **Response:** ``` Success! Jane Doe has been registered as a new candidate for job 'ENG-101' (shortcode: senior-frontend). I've added her email and initiated the application process. ``` ## Capabilities ### List open jobs Retrieves all current and archived job openings from the system. ### Get job details Pulls specific information, like requirements or descriptions, for a single job posting. ### Check candidate status Lists and inspects every candidate across all jobs in the pipeline. ### View individual profiles Drills down into a specific person's profile to see their experience, history, and current stage. ### Add new candidates Registers a brand-new candidate directly against a job opening to speed up sourcing. ### Review team structure Lists account members and recruiters, helping you understand who's involved in hiring. ## Use Cases ### Quickly assessing job needs A hiring manager asks their agent: 'What jobs are currently open?' The agent uses `list_jobs` to reply with a list of all openings, allowing the manager to immediately prioritize which roles need focus without opening the dashboard. ### Onboarding a new source A recruiter finds an excellent candidate on LinkedIn and needs them in the system. They tell their agent: 'Add Jane Doe for job ENG-101.' The agent uses `create_candidate`, registering her immediately, bypassing manual forms. ### Pipeline deep dive An HR manager wants to know how many people are in the final interview round. They prompt: 'List all candidates who are currently interviewing.' The agent runs `list_all_candidates` and filters the list based on status. ### Team check-in An operations team member asks their agent to see who is assigned to recruiting. The agent uses `list_account_members`, giving a structured overview of all active users on the hiring team. ## Benefits - Instead of navigating job boards manually, you can use the `list_jobs` tool to get a complete list of active and archived openings instantly. Your agent knows exactly what jobs are running. - You don't have to open 10 different tabs to check candidate status. Asking your agent to `list_all_candidates` gives you a single, consolidated view of everyone in the pipeline. - When you find a great passive lead, use `create_candidate` to programmatically register them against a job opening. It cuts out manual data entry and accelerates sourcing. - Need background on a promising applicant? The `get_candidate_profile` tool pulls deep details for any candidate, letting you review their experience and status without leaving your workflow. - It keeps your team aligned. Use `list_account_members` to instantly see who's on the recruiting team, so everyone knows who owns which pipeline segment. ## How It Works The bottom line is that you manage your entire recruiting machine by talking to your agent, not by clicking buttons in a dashboard. 1. Subscribe to this MCP and enter your Workable Subdomain and API Key. 2. Connect the service through any compatible AI client like Cursor or Claude. 3. Your agent gains immediate access, allowing you to start managing recruitment tasks using plain language queries. ## Frequently Asked Questions **How do I list all active job openings using Workable MCP?** You simply ask your agent to list jobs. The agent uses `list_jobs` and returns a comprehensive list of every open role in your account, whether it's currently posted or archived. **Can I add a candidate without using the Workable dashboard?** Yes, you can. Use the agent to run `create_candidate`. You just provide the candidate’s name and email, and it registers them instantly against your chosen job opening. **What if I need to see a specific person's history?** Run `get_candidate_profile` and specify the person's name. It pulls all their historical data, current status, and years of experience in one view. **Does Workable MCP help me manage my team structure?** Yes, you can run `list_account_members`. This provides a clear roster of who the recruiters are and what roles they have within your organization.