# Ashby MCP for AI Agents MCP

> Ashby MCP connects your AI client directly to a full-featured Applicant Tracking System. Use natural conversation to manage the entire recruiting pipeline, from listing and creating candidate profiles to retrieving detailed interview feedback and coordinating job openings.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** applicant-tracking, talent-acquisition, hiring-pipeline, candidate-management, recruitment-automation, scheduling

## Description

You can take control of your entire hiring process using only chat commands. Instead of toggling between browser tabs—one for job postings, another for candidate status, and a third for interview notes—your AI acts as the dedicated talent coordinator.

Need to know if Jane Smith is ready for the next round? Your agent can retrieve her full profile metadata and application details instantly. Want to check department-wide hiring health? You can list all open jobs and departmental directories in one query. The system also lets you programmatically manage candidates, creating new records or updating their status based on simple conversation.

This MCP makes your AI client an active participant in recruiting. Whether you're a sourcer needing to quickly build out candidate records or an HR ops specialist tracking user permissions, the power is conversational. This connection lives within the Vinkius catalog, allowing any compatible agent—like Claude, Cursor, or Windsurf—to access this deep pool of talent data without ever leaving your primary workspace.

## Tools

### create_ashby_candidate
Generates a brand new candidate profile within Ashby's system.

### get_ashby_application
Retrieves specific details about a single job application.

### get_ashby_candidate
Fetches all detailed information for one candidate by name or ID.

### get_ashby_job
Retrieves the full details of a specific open job posting.

### list_ashby_applications
Lists multiple applications and their current status across the platform.

### list_ashby_candidates
Provides a comprehensive directory listing of all candidates in your database.

### list_ashby_feedback
Gathers and lists submitted feedback reports from candidate interviews.

### list_ashby_interviews
Provides a list of scheduled and past interview events for tracking purposes.

### list_ashby_jobs
Retrieves an overview of all currently open job listings across the company.

### list_ashby_users
Lists internal users, such as recruiters and hiring managers, within your organization.

## Prompt Examples

**Prompt:** 
```
Show me all candidates who applied for software engineering last quarter and haven't had an interview yet.
```

**Response:** 
```
**Candidate Funnel Report: Software Engineering**

*   **Total Applicants:** 45
*   **Interviews Scheduled/Completed:** 12
*   **Candidates Needing Follow-Up (No Interview):** 33

Here are three names to review:

| Candidate | Application Date | Status | Next Action |
| :--- | :--- | :--- | :--- |
| @userX | 2024-10-05 | Applied | Schedule Initial Call |
| Jane Doe | 2024-09-18 | In Review | N/A |
| John Smith | 2024-10-22 | Pending Docs | Follow up on materials |

Do you want me to get the detailed application status for John Smith?
```

**Prompt:** 
```
Find all open jobs in Marketing and Engineering departments.
```

**Response:** 
```
**Current Open Roles**

Based on the latest directory, here are the active openings:

*   **Marketing:**
    *   Content Strategist (ID: job_102)
    *   SEO Specialist (ID: job_103)
*   **Engineering:**
    *   Backend Developer II (ID: job_245)
    *   DevOps Engineer (ID: job_246)

I can pull the hiring manager's contact details for any of these roles if you need them.
```

**Prompt:** 
```
What were the key takeaways from the last round of interviews?
```

**Response:** 
```
**Interview Feedback Summary**

Reviewing the reports from the last week (from @user3 and @user5): 

*   **Overall Sentiment:** Positive. Strong technical skills noted across candidates.
*   **Key Strength:** All reviewers highlighted excellent problem-solving abilities during live coding sessions.
*   **Areas for Improvement:** Some feedback pointed to a need for more structured communication in presentation tasks.

The average 'Recommend' rating is currently 4.1/5 stars.
```

## Capabilities

### List and manage candidate profiles
Lists all candidates or creates entirely new candidate records within the Ashby system.

### Retrieve application status details
Gets detailed metrics for a specific job application to track its progress.

### Get full candidate information
Fetches all available data points for one candidate using their ID or name.

### Get open job details
Retrieves the complete description and status of a particular role posting.

### List multiple applications
Generates an overview listing several applications across different roles or departments.

### List candidate directory
Provides a full, current list of every candidate in your talent pool.

### List interview feedback reports
Gathers and lists all submitted performance feedback from interviews for review.

### List scheduled interviews
Provides an overview of planned or completed interview events.

### List open job listings
Retrieves a comprehensive list of all available jobs across the company structure.

### List internal users directory
Provides a listing of internal employees, such as recruiters or hiring managers.

## Use Cases

### Quickly assessing a batch of applicants
A recruiter needs to see how 10 candidates fared in the last month. They ask their agent to list all applications and feedback, letting them compare 'list_ashby_applications' results against 'list_ashby_feedback' reports without opening ten separate dashboards.

### Coordinating a departmental hiring kickoff
A hiring manager needs an overview of who is available to interview. They ask the agent to list all open jobs and then cross-reference that with 'list_ashby_users' to ensure they know exactly which department heads are ready.

### Onboarding a new high-potential candidate
A sourcer finds an excellent passive candidate. They ask the agent to 'create_ashby_candidate', immediately adding them to the system, and then list all relevant open jobs using 'list_ashby_jobs' for instant matching.

### Reviewing a final-round interview pool
The team needs consensus on three finalists. They prompt the agent to retrieve detailed feedback reports via 'list_ashby_feedback' and also check their scheduled interviews using 'list_ashby_interviews'.

## Benefits

- Stop manually toggling between tabs. Use commands like 'list_ashby_candidates' to instantly get a full candidate summary, giving you immediate visibility.
- Never lose track of where a candidate stands. You can use 'get_ashby_application' and 'list_ashby_applications' to check detailed status metrics in real time.
- Summarize interviews faster than ever. Use 'list_ashby_feedback' to pull all high-fidelity reports, summarizing performance and sentiment for a quick decision.
- Keep your organization view perfect. Pull complete directories of open jobs and departments using 'list_ashby_jobs' or 'list_ashby_users', keeping everyone on the same page.
- Streamline initial intake. Use the 'create_ashby_candidate' tool to generate new records instantly, making them available for job linking right away.

## How It Works

The bottom line is that you get immediate, deep access to Ashby's talent data through natural language prompts, making your AI client act like an internal HR expert.

1. Subscribe to this MCP on Vinkius. Once connected, retrieve your API Key from the Ashby dashboard (Admin > API Keys).
2. Give a simple command to your AI client: 'List all candidates who applied for the Senior Developer role last month.'
3. Your agent processes the request and returns a structured list of candidate profiles and their current application statuses.

## Frequently Asked Questions

**How does the Ashby MCP help me track candidate progress?**
It lets you check a candidate's status and all their application details instantly through conversation. You get a real-time view of where they are in your hiring funnel, without opening multiple dashboards.

**Can I use the Ashby MCP to find open jobs?**
Yes. The MCP allows you to list all active job openings and retrieve specific details about any role using natural language prompts. This keeps your team fully updated on current needs.

**What if I need feedback from past interviews?**
You can pull detailed reports of submitted interview feedback right into the chat. This lets you summarize performance and sentiment for multiple candidates quickly, which is huge for final-round decisions.

**Is this MCP useful for HR operations tasks?**
Absolutely. You can use it to list internal users, check physical office locations, or automate oversight of job postings and user permissions using simple queries.

**Does the Ashby MCP help me manage my candidate database?**
It does. Beyond just viewing records, you can also create entirely new candidate profiles within the system through conversation, keeping your data clean and ready to use.