Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ASHBY_API_KEY | Yes | Your Ashby API key. Generate one at https://app.ashbyhq.com/admin/api/keys with candidatesRead, jobsRead, and candidatesWrite permissions. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| job_list | List all jobs (open, closed, archived). Supports cursor pagination and status filtering. |
| job_info | Get details of a single job by its ID. |
| job_search | Search for jobs by title. Not paginated; returns all matches. |
| candidate_list | List all candidates with cursor pagination. |
| candidate_search | Search candidates by email and/or name. Not paginated. |
| candidate_info | Get full details of a single candidate by ID. |
| candidate_create | Create a new candidate in Ashby. |
| candidate_create_note | Add a note to a candidate. Supports HTML formatting. |
| candidate_list_notes | List all notes for a candidate. |
| candidate_add_tag | Add a tag to a candidate. Use candidate_tag_list to find tag IDs. |
| candidate_tag_list | List all available candidate tags. |
| application_list | List applications. Can filter by jobId and/or status. Uses cursor pagination. |
| application_info | Get full details for a single application by ID. |
| application_create | Create an application linking a candidate to a job. |
| application_change_stage | Move an application to a different interview stage. |
| interview_stage_list | List all interview stages for a given interview plan. |
| interview_plan_list | List all interview plans. |
| interview_list | List all interviews with cursor pagination. |
| interview_info | Get details of a single interview by ID. |
| department_list | List all departments. |
| user_list | List all users (team members) in the organization. |
| source_list | List all candidate sources. |
| archive_reason_list | List all archive reasons (needed for application_change_stage to Archived). |
| location_list | List all locations. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |