Get candidate

One candidate with profile details, status, workflow steps and tags.

MCP tool comeet_read → get_candidate

read

Returns the profile fields Recruit shows (contact details, source, position, application answers when present), the status, the workflow with each step done or pending, scheduled interviews and tags. Resume files are not returned, only their names. Roles that may not see a hired candidate's evaluations get none.

Parameters

Parameters: get_candidate
NameTypeDescription
candidate_id string required string Candidate from list_candidates.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "comeet_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_3b90e4",
    "name": "Priya Nair",
    "position": "Senior Product Designer",
    "status": "in_progress",
    "source": "Careers website",
    "workflow": [
      {
        "step": "Application review",
        "state": "done"
      },
      {
        "step": "Interview with hiring manager",
        "state": "pending",
        "invitation": null
      }
    ],
    "scheduled_interviews": [],
    "tags": [
      "portfolio strong"
    ],
    "resume_files": [
      "priya-nair-cv.pdf"
    ]
  },
  "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.