Ashby
Tools to search candidates, manage applications, create notes and referrals, and query jobs and reports in your Ashby ATS workspace.
Overview
The Ashby MCP lets agents interact with your Ashby ATS workspace. It provides the ability to search for candidates and applications, retrieve job listings, look up users, create candidate notes, and submit referrals — all without leaving your Dust conversation.
Connection Setup (Admin)
- In Dust, go to Spaces → Tools and click Add Tools.
- Select Ashby from the list of available tools.
- Paste your Ashby API key into the field provided and save.
Once connected, the Ashby toolset will be available to add to agents in the spaces you grant access to.
Authentication
Ashby uses HTTP Basic Auth. The API key is passed as the Basic Auth username, with an empty password. Dust handles this automatically once you provide the API key.
See the official Ashby Authentication documentation for details.
Required API Key Permissions
In Ashby Admin → API Keys, create or edit your API key and grant at minimum the following permissions:
| Permission area | Access level | Required for |
|---|---|---|
| Candidates | Read + Write | candidate.search, candidate.listNotes, candidate.createNote, referral.create |
| Jobs | Read | job.list |
| Reports | Read | report.synchronous |
| Organization | Read | user.search |
| Hiring Process | Read | referralForm.info |
Optional toggles — enable these when your workspace data requires them:
- Allow access to confidential jobs and projects — needed if agents must read confidential job postings.
- Allow access to non-offer private fields — needed if agents must read private candidate fields.
For the full table of permissions and scopes, see the Ashby Authentication documentation.
Available Tools
| Tool | Description |
|---|---|
| Search Candidates | Search for candidates by name, email, or other criteria. |
| List Candidate Notes | Retrieve the notes attached to a candidate's profile. |
| Create Candidate Note | Add a new note to a candidate's profile. |
| Get Application Details | Retrieve details of a specific application, including stage and status. |
| Get Application Feedback | Retrieve interview feedback submitted for an application. |
| Get Referral Form | Retrieve the referral form configuration for a job. |
| Create Referral | Submit a new referral for a candidate to a job. |
| List Jobs | List active job postings in your Ashby workspace. |
| Run Synchronous Report | Execute a synchronous Ashby report and return the results. |
| Search Users | Search for users (employees/recruiters) in your Ashby organization. |
Updated about 12 hours ago