# Workable MCP for AI Agents AI Agent Connect

> Workable MCP lets you manage your entire hiring pipeline directly from your AI client. You can pull candidate profiles, list active job openings, and register new applicants without jumping between tabs. It turns your AI into a recruiting assistant that knows your specific team structure and candidate statuses.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_JDpVOjdiQNb0f6b99NfaFZ7nGqKHR0xgwmDfIXd7/ai-agent-connect
- **Tags:** applicant-tracking, hiring-workflow, candidate-screening, job-board-integration, recruitment-automation, talent-acquisition

## Description

This Workable MCP connects your Workable recruiting account to your AI agent so you can manage hiring pipelines, track candidates, and coordinate with your team through natural conversation. Instead of navigating complex menus or jumping between multiple browser tabs, you can just ask your agent for the information you need. You can pull candidate profiles to see experience levels, list all active job openings, or get a summary of your team's current workload. It turns the logistics of talent acquisition into a simple chat experience. By connecting this to the Vinkius catalog, you're giving your agent a direct line to your Workable instance. You can register new candidates to specific jobs as they come in, verify your account configuration, and keep your hiring flow moving without the manual data entry. It's about making the recruitment process feel like a conversation rather than a chore.

## Tools

### create_candidate
Register a new candidate to a job. This lets you add new leads to specific openings quickly.

### get_candidate_profile
Get details for a specific candidate. Use this to pull experience and status for a single person.

### get_job_details
Get details for a specific job. This retrieves the full requirements and descriptions for a role.

### list_all_candidates
List candidates across all jobs. Use this to see every applicant in your entire hiring pipeline.

### list_jobs
List active job openings. This gives you a quick overview of every role currently being filled.

### list_account_members
List hiring team members. This helps you understand who is on your team and their roles.

### list_linked_accounts
List connected accounts. Use this to verify your Workable instance configuration.

## Prompt Examples

**Prompt:** 
```
What jobs do we have open right now?
```

**Response:** 
```
You have 4 active job openings:

* **Senior Frontend Engineer**
* **Product Designer**
* **DevOps Specialist**
* **Marketing Lead**

Would you like to see the requirements for any of these?
```

**Prompt:** 
```
Can you give me a summary of John Smith's application?
```

**Response:** 
```
I've pulled the profile for John Smith.

**Status:** Interview Stage
**Role:** Senior Frontend Engineer
**Experience:** 8 years
**Notes:** Marked as 'Highly Recommended'.

He's currently moving through the final stages of the interview process.
```

**Prompt:** 
```
Register Jane Doe (jane.doe@example.com) for the senior frontend job.
```

**Response:** 
```
Success! I've registered Jane Doe as a new candidate for the 'Senior Frontend Engineer' role. Her email has been added and the application process has started.
```

## Capabilities

### Register new candidates
Add new applicants to specific job openings directly through your chat.

### Pull candidate profiles
Retrieve detailed experience and status for individual applicants instantly.

### List active job openings
Get a full list of every role currently being filled in your account.

### See hiring team structure
View your list of recruiters and team members to understand your internal layout.

### Check connected accounts
Verify your Workable instance configuration and linked accounts via your agent.

## Use Cases

### Checking candidate progress
A recruiter asks their agent to list candidates for a specific job and filter for those in the interview stage to prioritize their day.

### Reviewing job requirements
A hiring manager uses get_job_details to pull the full requirements and current status of a role to share with the team during a sync.

### Registering career fair leads
An HR manager uses create_candidate to register a new applicant to a specific job code as soon as they get their contact info.

### Mapping the hiring team
An ops lead uses list_account_members to see the current team structure and assign new jobs to the right people.

## Benefits

- Stop switching tabs by using list_jobs to see all active roles in one chat response.
- Get instant candidate summaries by pulling data with get_candidate_profile instead of clicking through profiles.
- Speed up your sourcing by using create_candidate to register new leads to specific jobs immediately.
- Keep your team organized by using list_account_members to verify who is handling which roles.
- Verify your setup quickly by using list_linked_accounts to check your instance configuration.

## How It Works

The bottom line is you get a way to run your recruitment workflow through a chat interface instead of a complex dashboard.

1. Subscribe to the Workable MCP through the Vinkius Marketplace.
2. Enter your Workable subdomain and API key into your AI client.
3. Start asking your agent to pull candidate data or update job statuses.

## Frequently Asked Questions

**Can the Workable MCP help me manage my hiring pipeline?**
Yes, it connects your Workable account to your AI client so you can ask questions about your jobs and candidates in plain English.

**How do I see all my candidates at once?**
You can ask your agent to list all candidates across all jobs, and it will pull the full list for you instantly.

**Can I add new applicants using the Workable MCP?**
Yes, you can tell your agent to register a new candidate for a specific job, and it will handle the data entry for you.

**Can I see who is on my hiring team?**
You can use the Connector to list all account members and recruiters to get a clear view of your team structure.

**Does the Workable MCP work with other AI clients?**
It works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**Can I check the details of a specific job posting?**
Yes, you can ask for the details of any job, and the Connector will retrieve the full requirements and descriptions.

**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.