# Workable Alternative MCP > Workable Alternative connects your AI agent directly into your job board and candidate tracking system. Ask it to list all open roles, check a candidate's application status, or build a new profile—all without leaving your chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hiring, applicant-tracking, recruitment, talent-acquisition, job-management ## Description Managing recruitment data shouldn't require opening twenty different tabs. This MCP lets you talk to your entire hiring pipeline using natural language. Need to know who is stuck in the 'Interview Stage'? Just ask. Want to create an application for a promising contact? Tell it to do it. The system gives you full control over job postings, candidate records, and the stages people move through—all from one conversation thread. When you connect this MCP, your credentials pass through Vinkius's zero-trust proxy; that means your sensitive HR keys are used only in transit and never saved to disk. You get the power of instant access without sacrificing security. This makes it a critical layer for any agent handling sensitive applicant data. ## Tools ### list_candidates Provides a list of multiple candidates, allowing you to see who's in the system. ### create_candidate Adds a brand new applicant profile to your Workable account. ### get_candidate Pulls all the detailed information for a single candidate ID. ### get_job Retrieves full details and descriptions for one specific job posting. ### list_jobs Lists all current and active job postings available for your company. ### list_recruiters Shows a list of internal recruiters or hiring team members in Workable. ### list_stages Lists all the defined steps or stages that candidates go through during your process. ## Prompt Examples **Prompt:** ``` List all current job openings in Workable. ``` **Response:** ``` I've retrieved your active job postings. You have 3 open roles: 'Senior Backend Engineer' (Shortcode: BE-001), 'Product Designer' (Shortcode: PD-042), and 'Sales Lead' (Shortcode: SL-009). ``` **Prompt:** ``` Show me the profile for candidate ID 'cand_123'. ``` **Response:** ``` Fetching candidate details... This is Jane Doe. She is currently a 'Full Stack Developer' with 5 years of experience. Her application summary mentions expertise in React and Node.js. ``` **Prompt:** ``` Create a candidate profile for John Smith (john@email.com) with the headline 'Senior Developer'. ``` **Response:** ``` Candidate profile created successfully! John Smith has been added to your Workable account as a 'Senior Developer'. ``` ## Capabilities ### List all active job openings Get a full list of every current job posting and their details. ### Check specific candidate records Retrieve complete profiles, contact info, and application summaries for one person. ### Build new applicant profiles Create brand new candidate accounts or applications directly from the chat interface. ### Track hiring workflow stages Understand and list every stage defined in your company's recruitment process. ### List team members and recruiters Get details on the internal staff involved in hiring, like recruiters or hiring managers. ## Use Cases ### A manager needs a headcount report quickly. Instead of asking the Recruiter to run a report and send an email, the agent runs `list_jobs` and then filters that data for specific roles (e.g., 'all engineering jobs'). The result is delivered immediately in chat. ### A candidate needs follow-up details. The Recruiter receives an email with a name but no context. They ask the agent to `get_candidate` using only the ID, and the full work history pops up instantly for review. ### A new role needs setup. The Hiring Manager just finished planning a job. The agent runs `list_stages` first, confirming the process flow, then uses `get_job` to template the final posting details before publishing. ## Benefits - Stop manually compiling job sheets. Use `list_jobs` to instantly get all active roles and their shortcodes, letting you draft targeted messages right away. - Never lose track of a promising contact again. You can use `get_candidate` to pull up full profiles—including summaries and contact details—on demand. - When onboarding new talent, don't waste time creating records manually. Use `create_candidate` to add an applicant profile instantly based on conversation notes. - Need a quick status check? Running `list_candidates` shows you who’s in the system without needing to navigate through complex dashboards. - Automate reporting by running `list_stages`. This tells you exactly what steps are available, helping you see where your process might be slowing down. ## How It Works The bottom line is: you talk to the system once, and the agent handles the complex API calls needed to pull or push data across your entire talent pipeline. 1. Subscribe to this MCP and enter your Workable API key along with your subdomain. 2. Connect it to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent a question like, 'List all open roles for backend engineers,' and get the data back. ## Frequently Asked Questions **Can I retrieve the full details of a specific job posting?** Yes! Use the `get_job` tool with the job's shortcode. Your agent will return the full job description, requirements, and metadata associated with that posting. **Is it possible to add a new candidate directly through the AI?** Absolutely. Use the `create_candidate` action. You can provide the candidate's name, email, headline, and a summary to instantly create their profile in your Workable account. **How can I see the different steps in our recruitment process?** Simply ask the agent to run the `list_stages` tool. It will provide a list of all configured hiring stages, helping you understand where candidates are in the pipeline. **How do I use `list_candidates` if I need a filtered view of my job applicants?** Yes, you can filter candidate lists by status or role. Simply tell your agent what criteria to use when running the list_candidates tool. For example, 'Show me all candidates in the 'Interviewing' stage who are 'Developer' roles.' The agent handles the filtering logic for you. **What if I run into an error using `get_candidate`? Does it mean the candidate doesn't exist?** An error usually means the specific ID provided isn't found or is inaccessible. If your agent gets a failure, check that you gave it the correct unique identifier; sometimes a simple typo in the ID will cause the tool to fail. **Can I use `list_recruiters` to see who owns which job opening?** Yes. Running list_recruiters gives you an overview of team members. You can then ask your agent to cross-reference that data with active job postings to determine ownership or assignment. **What happens if I forget to provide my Workable API Key when setting up the MCP?** The connection will fail immediately and prevent any tool calls. You must enter your valid credentials first, otherwise, your agent won't have permission to communicate with your account. **Is there a way for my agent to track job openings that are currently active but not yet listed?** No, the MCP only interacts with data Workable officially tracks. To know about an unlisted opening, you'd need external information; running list_jobs will only show postings that have already been made public in your account.