Ashby

Ashby is a modern applicant tracking system (ATS) for recruiting teams. The Ashby MCP server lets you manage jobs, candidates, applications, and interview schedules using natural language.

What Can It Do?

Find and manage candidates with search and filters
Create applications and transfer them between jobs
Submit interview feedback and review feedback form definitions
Read interview scorecards and AI-generated criteria evaluations for applications
Download candidate files and interview transcripts into Gumloop storage
View application history and change application stages
Create and update interview schedules with timing and participants
Manage interview plans, stages, and events across jobs
Manage interviewer pools with training requirements and roster updates
Create jobs, job postings, offers, and openings end-to-end
Maintain job status as roles open, pause, or close
Move applications through stages with notes and tags
Read org-wide metadata like departments, locations, sources, custom fields, archive reasons, and communication templates
Manage webhook subscriptions for real-time event notifications

Where to Use It

In Agents (Recommended)

Add Ashby as a tool to any agent. The agent can then interact with your recruiting data conversationally, choosing the right actions based on context.

To add an MCP tool to your agent:

Open your agent’s configuration
Click Add tools → Connect an app with MCP
Search for the integration and select it
Authenticate with your account

You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Ashby tools. This gives you the flexibility of an agent within a deterministic workflow.

As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.

To create a custom MCP node:

Go to your node library and search for the integration
Click Create a node with AI
Describe the specific action you want (e.g., “List all open jobs in Engineering”)
Test the node and save it for reuse

Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

Available Tools

Tool	Description
List/Get Users	Search and get user details
List/Get Jobs	Search jobs with filters
Update Job	Update job properties
Set Job Status	Change job status (open/closed)
List/Get Candidates	Search candidates
Create Candidate	Create a new candidate
Update Candidate	Update candidate info
Add Candidate Tag	Tag a candidate
Create Candidate Note	Add a note to a candidate
List/Get Applications	Search applications
Update Application	Update application properties
Change Application Stage	Move to a different stage
Change Application Source	Update the source
List/Get Interviews	Search interviews
List/Get Interview Schedules	Get interview schedules
Create Interview Schedule	Schedule an interview
Update Interview Schedule	Modify a schedule
Cancel Interview Schedule	Cancel a schedule
List/Get Interviewer Pools	Manage interviewer pools
Add User To Interviewer Pool	Add interviewers
Create Interviewer Pool	Create a new interviewer pool
Update Interviewer Pool	Update an interviewer pool’s title or training requirements
Create Application	Create an application to consider a candidate for a job
Transfer Application	Transfer an application to a different job
List Application History	Get the stage transition history for an application
Submit Application Feedback	Submit interview feedback for an application
List Application Feedback	List interview scorecards and feedback submissions for an application
List Application Criteria Evaluations	List AI-generated criteria evaluations for an application
List Candidate Files	List resume and attached files associated with a candidate
Download File	Download a file or interview transcript from Ashby to Gumloop storage
List Candidate Notes	List all notes on a candidate with pagination
Get Job Info	Get detailed information about a specific job
Get Job Interview Plan	Get the interview plan for a job including stages and activities
List Interview Plans	List all interview plans with pagination
List Interview Stages	List all interview stages for a plan in order
Get Interview Stage Info	Get detailed information about a specific interview stage
List Interview Stage Groups	List all interview stage groups with ordering
List Interview Events	List all interview events for a specific interview schedule
List Hiring Team Roles	List all available hiring team roles
List Archive Reasons	List all archive reasons used when archiving applications
List Departments	List all departments in the organization
List Locations	List all locations in the organization
List Sources	List all recruiting sources for candidate attribution
List Custom Fields	List all custom fields defined in the organization
Set Custom Field Value	Set the value of a custom field on a candidate or application
List Communication Templates	List all email communication templates
Create Job	Create a new job posting
List Job Postings	List all job postings with pagination
Get Job Posting Info	Get detailed information about a specific job posting
List Feedback Form Definitions	List all feedback form definitions for interview evaluations
Get Feedback Form Definition Info	Get detailed information about a specific feedback form definition
Create Offer	Create a new offer for an application
Get Offer Info	Get detailed information about a specific offer
List Offers	List all offers with pagination
List Openings	List all job openings with pagination
Get Opening Info	Get detailed information about a specific job opening
Create Webhook Subscription	Create a webhook subscription for real-time event notifications
Delete Webhook Subscription	Delete a webhook subscription

Example Prompts

Use these with your agent or in the Agent Node: Find open jobs:

List all open jobs in the Engineering department

Search candidates:

Find candidates who applied for the Senior Engineer role

Move an application:

Move Sarah Chen's application for Product Manager to the Interview stage

Schedule an interview:

Schedule an interview for John Doe tomorrow at 2pm with the hiring manager

Add a note:

Add a note to candidate Emily Wang: "Strong technical background, proceed to final round"

Create an application:

Create an application for candidate Emily Wang for the Senior Engineer role

Submit interview feedback:

Submit positive feedback for John Doe's Product Manager application using the "Technical Screen" form

List openings and postings:

Show me all open openings and their active job postings in the Engineering department

Check application history:

Show the stage transition history for Sarah Chen's Product Manager application

Create an offer:

Create an offer for John Doe's Senior Engineer application starting next Monday

Download a candidate’s resume:

Download the resume for candidate Emily Wang and save it to my workspace

Review interview feedback:

Show me all the interview scorecards and criteria evaluations for John Doe's Senior Engineer application

Troubleshooting

Issue	Solution
Agent not finding the right data	Use specific job titles or candidate names/emails
Action not completing	Check that you’ve authenticated and have the necessary Ashby permissions
Unexpected results	The agent may chain multiple tools (e.g., finding the candidate first, then updating). Review the agent’s reasoning to understand its approach.
Tool not available	Verify the tool is enabled in your agent’s MCP configuration

Agents are smart enough to chain multiple API calls together. For example, asking “Move John’s application to the next stage” will find the candidate and application first, then update the stage. If results seem off, check the agent’s step-by-step reasoning.

Need Help?

Agents documentation for setup and best practices
Agent Node guide for workflow integration
Need help? Reach out to us
Contact support@gumloop.com for assistance

Use this integration directly in Claude or Cursor. Connect remotely via the Ashby MCP server using credentials from your Connectors page.

Get Started

Core Concepts

Enterprise Features

Nodes

Common Errors

What Can It Do?

Where to Use It

In Agents (Recommended)

In Workflows (Via Agent Node)

As a Custom MCP Node

Available Tools

Example Prompts

Troubleshooting

Need Help?

​What Can It Do?

​Where to Use It

​In Agents (Recommended)

​In Workflows (Via Agent Node)

​As a Custom MCP Node

​Available Tools

​Example Prompts

​Troubleshooting

​Need Help?

What Can It Do?

Where to Use It

In Agents (Recommended)

In Workflows (Via Agent Node)

As a Custom MCP Node

Available Tools

Example Prompts

Troubleshooting

Need Help?