Skip to main content
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 and update interview schedules with timing and participants
  • Maintain job status as roles open, pause, or close
  • Move applications through stages with notes and tags

​
Where to Use It

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:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. 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:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “List all open jobs in Engineering”)
  4. 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

ToolDescription
List/Get UsersSearch and get user details
List/Get JobsSearch jobs with filters
Update JobUpdate job properties
Set Job StatusChange job status (open/closed)
List/Get CandidatesSearch candidates
Create CandidateCreate a new candidate
Update CandidateUpdate candidate info
Add Candidate TagTag a candidate
Create Candidate NoteAdd a note to a candidate
List/Get ApplicationsSearch applications
Update ApplicationUpdate application properties
Change Application StageMove to a different stage
Change Application SourceUpdate the source
List/Get InterviewsSearch interviews
List/Get Interview SchedulesGet interview schedules
Create Interview ScheduleSchedule an interview
Update Interview ScheduleModify a schedule
Cancel Interview ScheduleCancel a schedule
List/Get Interviewer PoolsManage interviewer pools
Add User To Interviewer PoolAdd interviewers

​
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"

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific job titles or candidate names/emails
Action not completingCheck that you’ve authenticated and have the necessary Ashby permissions
Unexpected resultsThe agent may chain multiple tools (e.g., finding the candidate first, then updating). Review the agent’s reasoning to understand its approach.
Tool not availableVerify 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?

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