# Ashby MCP

> Ashby MCP manages your entire recruiting pipeline through natural language commands. Your AI agent can list all active jobs, search for candidates by name or email, and pull full application details without you switching tabs. It gives you a single source of truth for job listings, candidate profiles, and interview schedules.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** applicant-tracking, candidate-sourcing, recruitment-pipeline, interview-scheduling, job-management

## Description

Managing hiring involves juggling dozens of systems—job boards, CRM tools, calendar invites. You spend hours copying IDs and navigating between different dashboards just to get a status update on one person. This MCP changes that. It connects your AI agent directly to Ashby, letting you talk about your pipeline like it's already in your head.

Instead of running five separate reports, you simply ask for what you need. You can list all open jobs and then immediately pull the detailed profile for a candidate who applied last week. Need to check on an interview? Ask. The MCP gives your agent enough context that it doesn't just dump raw data; it organizes it into usable insights. This is how Vinkius brings powerful, specialized tools like Ashby directly into your AI workflow, letting you treat complex HR operations as simple conversations.

## Tools

### get_account_check
Verifies the connection status to your Ashby account.

### get_application_info
Retrieves all specific details about a single job application.

### get_candidate_info
Pulls the complete profile and contact information for one candidate.

### get_job_info
Gets comprehensive details for a single, specific job listing.

### list_applications
Lists every job application currently recorded in the system.

### list_candidates
Retrieves a list of all candidates stored within Ashby.

### list_interviews
Lists all scheduled interviews to keep track of the recruiting calendar.

### list_jobs
Provides a list of job listings, supporting filtering by status (open, closed, etc.).

### search_candidates
Searches for and finds candidates using their name or email address.

### search_jobs
Searches for job openings based on keywords in the title.

## Prompt Examples

**Prompt:** 
```
List all currently opened jobs in Ashby.
```

**Response:** 
```
I've retrieved your open jobs. You have 4 opened positions: 'Senior Frontend Engineer', 'Product Designer', 'Customer Success Manager', and 'Sales Lead'.
```

**Prompt:** 
```
Search for a candidate named 'John Doe'.
```

**Response:** 
```
I found 1 candidate matching 'John Doe' (ID: cand_123). He is currently tagged with 'Engineering' and 'Referral'.
```

**Prompt:** 
```
Show me the details of application 'app_998877'.
```

**Response:** 
```
Application 'app_998877' is for the 'Senior Frontend Engineer' role. The current status is 'Technical Interview' and it was created on Feb 1st.
```

## Capabilities

### Audit and list job listings
Retrieve a complete list of all jobs—open, closed, or archived—and get detailed metadata for any specific position.

### Search for talent profiles
Find candidates quickly using names or emails, and pull up their full profile including tags and contact information.

### Track application status
Monitor where every job application stands by filtering results based on the specific job ID or current workflow stage.

### Review interview schedules
Get a list of all scheduled interviews so you stay organized and never miss a meeting date.

### Verify account connection
Confirm that the MCP has successfully linked to your Ashby account for immediate use.

## Use Cases

### The end-of-day status report
A recruiter needs to know if the top 5 candidates are moving forward. They ask their agent, 'List all applications for Senior Frontend Engineer and check the latest status.' The agent uses `list_applications` and then retrieves specific details using `get_application_info`, giving a clean summary without manual data extraction.

### Quickly vetting a referral
A hiring manager gets an email with a name. Instead of searching the database manually, they ask their agent to 'Search for John Doe.' The tool uses `search_candidates` and provides the full profile using `get_candidate_info`, including contact info and tags.

### Checking job market gaps
A Talent Ops specialist wants to see if they have enough roles open in a specific department. They prompt the agent, 'List all jobs with status Open.' The tool runs `list_jobs`, allowing them to immediately assess the current volume of openings.

### Investigating an old application
A recruiter needs historical data on a candidate. They provide the ID and ask their agent to show details, running `get_application_info` to confirm the job role and previous workflow stages.

## Benefits

- Stop switching tabs. Instead of moving between job boards and CRM dashboards, you ask your agent for a candidate's status, pulling all the necessary data in one go using `get_candidate_info` and `list_applications`.
- Get immediate oversight on your hiring rhythm. You can use `list_jobs` to see exactly how many positions are open or archived, giving you an instant view of capacity without running reports.
- Never lose track of a candidate again. Use `search_candidates` followed by `get_candidate_info` to pull up full profiles and tags instantly, making sourcing much faster.
- Stay on top of your schedule using the `list_interviews` tool. You get a clean list of upcoming interviews so you can plan follow-ups without checking a separate calendar app.
- Streamline reporting by querying job details with `get_job_info`. This lets your agent pull structured data about requirements and metadata for multiple roles at once.

## How It Works

The bottom line is you get comprehensive hiring intelligence delivered directly back into your chat window, without leaving your current workspace.

1. You connect your preferred AI client and authorize access using your API key.
2. Your agent sends a natural language prompt, such as 'Find all candidates tagged with Engineering who applied to the Product Designer role.'
3. The MCP translates that request into specific tool calls, fetching job data, candidate profiles, and application status in one sequence.

## Frequently Asked Questions

**How does the Ashby MCP connect to my existing accounts?**
You initiate the connection through Vinkius by providing your API key during setup. The agent then uses `get_account_check` to verify the link is active before running any commands.

**Can I use the Ashby MCP to update candidate records?**
No, this MCP is designed for reading data only. It allows your agent to retrieve profiles using `get_candidate_info` but cannot write or modify data within Ashby.

**Does the Ashby MCP support filtering open jobs?**
Yes, you can use the `list_jobs` tool and specify filters like 'open' or 'closed' to narrow down job listings immediately.

**What if I want to find a candidate by their email?**
Use the `search_candidates` tool. You only need to provide the name or email, and it will locate the correct profile for you.

**Does the Ashby MCP handle interview scheduling?**
The MCP can list all scheduled interviews using `list_interviews`, helping you stay organized. However, it does not actually book or modify calendar appointments.