get_candidate
Get Candidate
Gets the exact candidate by ID or by an unambiguous email/name search. Multiple matches require a refined search or an exact ID; visibility depends on API-key permissions.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_candidate
Gets the exact candidate by ID or by an unambiguous email/name search. Multiple matches require a refined search or an exact ID; visibility depends on API-key permissions.
create_job
Creates a new job in Ashby with a title, required location and department/team IDs, and an optional default interview plan. Use list_organization to discover the location and department. Returns the created job's ID and basic details.
update_job
Updates a job's details, status, or compensation. Supports changing the title, location, department, status, and compensation in a single call.
manage_interview_schedule
Creates, updates, cancels, or lists interview schedules in Ashby. Use this tool to coordinate interview scheduling for candidates in the hiring pipeline.
update_candidate
Updates a candidate's profile in Ashby. Supports changing name, email, phone, social links, adding tags, creating notes, and assigning to projects. Multiple operations can be performed in a single call.
create_application
Creates a new application for a candidate on a job in Ashby. An application represents a candidate's progression through the hiring pipeline for a specific job. Optionally specify an interview plan, starting stage, source, or credited user.
list_applications
Lists applications with pagination or retrieves detailed information about a specific application. Applications represent a candidate's progress through the hiring pipeline for a particular job.
list_organization
Discovers departments, locations, users, sources, archive reasons, tags, candidates, projects, custom fields, interview plans/stages/interviews and hiring roles needed by the existing tools. Returns one page where pagination is supported; user search requires an exact email.
list_jobs
Lists one native job page, reads an exact jobId, or performs bounded title search. Status-only filtering uses the list endpoint. Combined title/status filtering applies status to the bounded search results.
set_custom_field
Sets a custom field value on an Ashby entity. Use the list organization tool with `resourceType` set to `custom_fields` to discover definitions and their supported object types. Offer fields use manage_offer forms; this endpoint does not support Offer.
update_application
Updates an existing application in Ashby. Supports multiple actions: change the interview stage (optionally with an archive reason), change the application source, transfer the application to a different job, and add or remove hiring team members. Multiple actions can be performed in a single call.
manage_offer
Reads/lists offers, submits native offer forms, starts a version in an existing prepared process, or force-approves the exact latest version. Process, form, application and version IDs are distinct; no approval or delivery is implied by form submission.
create_candidate
Creates a candidate with a full name and primary personal email/phone. Social links are set with a separate documented update; these operations are not atomic. Other legacy contact types are rejected before writes.
download_file
Prepares a downloadable candidate file, resume or offer document using its exact provider file handle. Requires candidatesRead. Ashby-generated demo files may not be downloadable.
get_current_api_key
Shows the connected API key title, creation time, endpoint permissions and observed API version. Requires apiKeysRead. It does not identify a human user or reveal the key.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Read and manage candidates, applications, jobs, offer forms and interview schedules. Discover required organization resources, inspect the connected API key and download provider files.
Common questions about connecting Ashby to AI agents with Metorial.