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.