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.Documentation Index
Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
Use this file to discover all available pages before exploring further.
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
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.- 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: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 |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact support@gumloop.com for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the Ashby MCP server using your Gumloop credentials.