Get candidate

One candidate record with skills, employment history, applications and recent notes.

MCP tool jobadder_read → get_candidate

read

Returns the profile of one candidate: contact details, skills, employment history and education, their applications with job and status, and the most recent notes. A candidate your JobAdder user cannot open returns APP_PERMISSION_DENIED. Attachments such as the original resume file are not returned.

Parameters

Parameters: get_candidate
NameTypeDescription
candidate_id string required string Candidate id from search_candidates or list_job_applications.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jobadder_read",
    "arguments": {
      "operation": "get_candidate",
      "arguments": {
        "candidate_id": "candidate_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "candidate_id": "cand_20931",
    "name": "Priya Nair",
    "email": "priya.nair@example.com",
    "skills": [
      "Financial reporting",
      "Xero",
      "Month-end close"
    ],
    "employment": [
      {
        "title": "Senior Accountant",
        "company": "Harbour Partners",
        "years": "2020-2026"
      }
    ],
    "applications": [
      {
        "application_id": "app_48213",
        "job": "Senior Accountant",
        "status": "Phone screen"
      }
    ],
    "notes": [
      {
        "note_id": "note_77310",
        "text": "Referred by a client.",
        "created_at": "2026-10-14T09:12:00+11:00"
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.