# Workable MCP for AI Agents AI Agent Connect > Workable connects your recruitment data to your AI agent. You can manage job postings, track candidate applications, and oversee your hiring pipeline without leaving your chat interface. It turns your AI into a talent acquisition assistant that knows your specific job roles and candidate history. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_RGVIfc18ijjAqUUuReshwX7RquS75HuJNreZVXjF/ai-agent-connect - **Tags:** applicant-tracking, hiring-workflow, candidate-screening, job-board-integration, recruitment-automation, talent-acquisition ## Description If you're spending half your day jumping between browser tabs to check candidate statuses or hunt down job descriptions, this Connector is for you. It connects your Workable account to your AI agent so you can handle the heavy lifting of talent acquisition through a simple chat interface. Instead of manually searching for a specific person's phone number or checking if a role is still open, you just ask your agent. It pulls the data directly from your account, keeping you in your flow. You can have your agent draft new profiles, summarize applications, or give you a pulse check on recruiter workloads. Since Vinkius makes it easy to connect these tools, you get a unified way to manage your talent pipeline without the usual administrative headache. It’s about getting rid of the "where did I see that" moments and moving straight to making hiring decisions. You can see who's in your talent pool, get the specifics on any job posting, and keep your pipeline moving without the constant context switching. ## Tools ### get_candidate_profile Get details for a specific candidate ### get_job_details Get details for a specific job ### list_linked_accounts List connected accounts ### list_all_candidates List candidates across all jobs ### list_account_members List hiring team members ### list_jobs Show all current job postings in your Workable account. This gives your agent a full view of what's currently open. ### create_candidate Add a new candidate to your Workable account. You can do this directly from a chat conversation. ## Prompt Examples **Prompt:** ``` Show me the active job postings. ``` **Response:** ``` I've pulled your current job postings from Workable. Here are the 3 active roles: | Role | Shortcode | Status | | :--- | :--- | :--- | | **Senior Backend Engineer** | BE-001 | Open | | **Product Designer** | PD-042 | Open | | **Sales Lead** | SL-009 | Open | ``` **Prompt:** ``` Who is Jane Doe? ``` **Response:** ``` I've retrieved the details for Jane Doe. * **Current Role:** Full Stack Developer * **Experience:** 5 years * **Summary:** She has extensive expertise in React and Node.js. Her application highlights a strong background in building scalable web applications. ``` **Prompt:** ``` Add a new candidate for John Smith. ``` **Response:** ``` I've successfully added John Smith to your Workable account. * **Name:** John Smith * **Headline:** Senior Developer * **Email:** john@email.com He is now appearing in your candidate list. ``` ## Capabilities ### Create new candidate profiles Add new people to your database directly from your chat conversation. ### Pull specific job details Fetch exact job descriptions and requirements instantly. ### List all active job postings See every open role in your account in one glance. ### View recruiter team members Check which recruiters are active and handling your roles. ### Track hiring pipeline stages Understand exactly where every applicant stands in your process. ### Retrieve candidate contact info Get phone numbers and email addresses without searching through files. ## Use Cases ### Checking who applied for a specific role A recruiter asks the agent to show all applicants for the Senior Dev position. The agent uses list_candidates to filter the list. ### Adding a new applicant from an email A hiring manager gets an email and asks the agent to create a profile for the person. The agent uses create_candidate to add them. ### Reviewing hiring progress A TA lead asks for a status update on the Product Designer role. The agent uses get_job and list_stages to summarize the progress. ### Checking team capacity A manager wants to see who is handling the current roles. The agent uses list_recruiters to show the team breakdown. ## Benefits - Stop switching tabs by using list_jobs to see all active roles in one place. - Quickly find contact info using get_candidate so you can reach out to talent faster. - Add new applicants instantly with create_candidate to keep your database current. - Stay organized by using list_stages to understand exactly where every applicant stands. - Get a bird's eye view of your team by using list_recruiters to see who's doing what. - Pull job requirements with get_job to ensure your AI has the right context for every task. ## How It Works The bottom line is you get a direct line to your recruitment data without the manual clicking. 1. Subscribe to the Workable MCP on Vinkius. 2. Provide your Workable API key and subdomain in the setup. 3. Ask your AI client to list jobs or find candidates. ## Frequently Asked Questions **Can I use the Workable MCP to see my current job openings?** Yes, you can ask your AI agent to list all active job postings. It will pull the data directly from your account and show you the roles, shortcodes, and current statuses. **How does the Workable MCP help with candidate tracking?** It allows your agent to see exactly where every applicant stands in your pipeline. You can ask for summaries of specific candidates or see the overall status of your hiring stages. **Can I add new candidates to Workable using my AI agent?** Yes, you can tell your agent to create a new candidate profile. It will take the information you provide in the chat and add it to your Workable database automatically. **Does the Workable MCP show me my team of recruiters?** It does. You can ask your agent to list your recruiters to see who is currently managing your talent acquisition efforts. **Can I use Workable MCP to manage my hiring stages?** Yes, the Connector allows your agent to understand and list the different stages of your recruitment process, making it easier to track progress across multiple roles. **Is the Workable MCP good for high-volume hiring?** It is designed specifically for that. By automating the retrieval of candidate info and job details, it helps you manage large numbers of applicants without the manual overhead. **How do I connect Workable to my AI client?** You can connect it by subscribing to the Connector on Vinkius and providing your Workable API key and subdomain. Once connected, your AI client can access all the tools. **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 find the shortcode for a specific job?** Use the `list_jobs` tool. It returns a list of all your openings, each with its unique shortcode required for more detailed queries or actions. **Can I add a new candidate directly to a job via AI?** Yes! Use the `create_candidate` action. Provide the job shortcode along with the candidate's name and email to register them in your Workable pipeline. **Is it possible to see the recruiter assigned to an account?** Absolutely. Run the `list_account_members` query to retrieve the directory of all users and recruiters in your instance, including their roles.