Get candidate
One candidate profile: applications, stage, notes, recent emails and scheduled interviews.
MCP tool ashby_read → get_candidate
read
Returns the profile fields Ashby shows on the candidate page, plus every application with its stage and archive reason if archived. Notes and emails come newest first. Private fields appear only if your account can see them.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate ID from search_candidates. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ashby_read",
"arguments": {
"operation": "get_candidate",
"arguments": {
"candidate_id": "candidate_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": "e1f7a309-4c52-4d8b-a063-9b25d7c1e840",
"name": "Ana Costa",
"email": "ana.costa@example.com",
"source": "Referral",
"applications": [
{
"application_id": "9c41b7a2-6e03-4d58-a1f9-3b8d25e07c64",
"job": "Product Designer",
"stage": "Offer",
"status": "Active",
"offer": null
}
],
"notes": [
{
"author": "Priya Nair",
"created_at": "2026-10-14T10:12:00+02:00",
"text": "Strong portfolio, wants a start in mid November."
}
],
"recent_emails": [
{
"direction": "sent",
"subject": "Next steps",
"sent_at": "2026-10-12T09:30:00+02:00"
}
],
"interviews": [
{
"interview": "Design review",
"start": "2026-10-13T15:00:00+02:00",
"status": "Completed"
}
]
},
"isError": false
}