Skip to main content
Glama

Get a candidate

get_candidate
Read-onlyIdempotent

[Candidates] One candidate in full: profile, applications with their steps and decisions, tags and automatic tags, counts of notes, open tasks, document requests and segments, and the duplicate flag. include=notes,duplicates,documents,tasks,segments adds those lists; a section whose feature is off is named in unavailable. Candidate data is decision-support material for a human reviewer.

Every argument in full, with examples: get_tool_reference.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "candidate_id": "<candidate_id>"
    },
    "name": "get_candidate"
  }
}

Input Schema

NameRequiredDescriptionDefault
includeNoComma list of extra sections: notes, duplicates, documents, tasks, segments. Default: none of them.
llm_modelNoYour model id, e.g. "claude-opus-4-8"; "unknown" if unsure. For analytics.
candidate_idYesCandidate id (the `id` of a list_candidates row).
conversation_idNoThe conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics.

Output Schema

NameRequiredDescriptionDefault
dataYes
_mcp_instructionsNoServer-issued metadata for this conversation.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / candidate_id / description
      Previous value: -"Candidate id (profile_interview.id)."New value: +"Candidate id (the `id` of a list_candidates row)."
  2. Changed153 schema fields changed
    • removedInput schema / properties / include / example
      Removed value: -"notes,tasks"
    • addedInput schema / properties / llm_model
      Added value: +{
      +  "description": "Your model id, e.g. \"claude-opus-4-8\"; \"unknown\" if unsure. For analytics.",
      +  "type": "string"
      +}
    • removedOutput schema / properties / data / properties / applications / description
      Removed value: -"Applications to positions visible to you, newest first."
    • removedOutput schema / properties / data / properties / applications / items / properties / assigned_profile_id / description
      Removed value: -"Recruiter assigned to the application (profile.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / created_at / description
      Removed value: -"Applied (ISO 8601)."
    • removedOutput schema / properties / data / properties / applications / items / properties / current_step_id / description
      Removed value: -"The current step (position_result_step.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / decision_reason_id / description
      Removed value: -"Decision reason id (merchant_taxonomy.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / decision_reason_note / description
      Removed value: -"Note on the decision."
    • removedOutput schema / properties / data / properties / applications / items / properties / decision_status / description
      Removed value: -"Decision: recruiter_accept, recruiter_reject, recruiter_action, ai_accept, ai_reject, candidate_action or processing."
    • removedOutput schema / properties / data / properties / applications / items / properties / id / description
      Removed value: -"Application id (position_result.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / is_test / description
      Removed value: -"A test application."
    • removedOutput schema / properties / data / properties / applications / items / properties / outcome / description
      Removed value: -"Outcome: pending, hired or declined."
    • removedOutput schema / properties / data / properties / applications / items / properties / outcome_at / description
      Removed value: -"When the outcome was set (ISO 8601)."
    • removedOutput schema / properties / data / properties / applications / items / properties / position_id / description
      Removed value: -"Position id (position_def_set.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / position_name / description
      Removed value: -"Position name."
    • removedOutput schema / properties / data / properties / applications / items / properties / status / description
      Removed value: -"Application state: draft, active, archived, deleted, preparing or completed."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / description
      Removed value: -"The steps reached, in process order."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / created_at / description
      Removed value: -"When the candidate reached the step (ISO 8601)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / decision_reason_id / description
      Removed value: -"Decision reason id (merchant_taxonomy.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / decision_status / description
      Removed value: -"Decision: recruiter_accept, recruiter_reject, recruiter_action, ai_accept, ai_reject, candidate_action or processing."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / id / description
      Removed value: -"Application step id (position_result_step.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / interview_result_id / description
      Removed value: -"Interview result of the step (interview_result.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / name / description
      Removed value: -"Step name (the step type when unnamed)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / position_step_id / description
      Removed value: -"Position step id (position_def_step.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / pre_screening_id / description
      Removed value: -"Pre-screening of the step (interview_result_pre_screening.id)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / processing_status / description
      Removed value: -"Analysis state: new, processing, completed or failed."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / sequence_no / description
      Removed value: -"Order in the process."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / skipped_at / description
      Removed value: -"When the step was skipped (ISO 8601)."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / status / description
      Removed value: -"Step state: draft, active, archived, deleted, preparing or completed."
    • removedOutput schema / properties / data / properties / applications / items / properties / steps / items / properties / type / description
      Removed value: -"Step type: pre-screening, interview, invited, meeting, external_assessment or certo_verification."
    • removedOutput schema / properties / data / properties / applications / items / properties / updated_at / description
      Removed value: -"Last changed (ISO 8601)."
    • removedOutput schema / properties / data / properties / applications / items / properties / withdrawn_at / description
      Removed value: -"When the application was withdrawn (ISO 8601)."
    • removedOutput schema / properties / data / properties / auto_tags / description
      Removed value: -"Automatic tags (recent_applicant, completed_interview, no_show, inactive_90d, previous_applicant, prospect, possible_duplicate, careers_chat_lead)."
    • removedOutput schema / properties / data / properties / avatar_local_path / description
      Removed value: -"Avatar storage path."
    • removedOutput schema / properties / data / properties / avatar_url / description
      Removed value: -"Avatar image URL."
    • removedOutput schema / properties / data / properties / counts / description
      Removed value: -"Counts."
    • removedOutput schema / properties / data / properties / counts / properties / notes / description
      Removed value: -"Notes you can read: on the candidate, its visible interview results and pre-screenings."
    • removedOutput schema / properties / data / properties / counts / properties / open_document_requests / description
      Removed value: -"Open document requests (switch document_requests)."
    • removedOutput schema / properties / data / properties / counts / properties / open_tasks / description
      Removed value: -"Open tasks you can see (switch tasks)."
    • removedOutput schema / properties / data / properties / counts / properties / segments / description
      Removed value: -"Saved segments the candidate is in."
    • removedOutput schema / properties / data / properties / created_at / description
      Removed value: -"Created (ISO 8601)."
    • removedOutput schema / properties / data / properties / custom_fields / description
      Removed value: -"Company-defined candidate fields (key: value; switch custom_fields)."
    • removedOutput schema / properties / data / properties / documents / description
      Removed value: -"With include=documents: document requests, newest first."
    • removedOutput schema / properties / data / properties / documents / items / properties / application_id / description
      Removed value: -"Application (position_result.id)."
    • removedOutput schema / properties / data / properties / documents / items / properties / cancelled_at / description
      Removed value: -"Cancelled (ISO 8601)."
    • removedOutput schema / properties / data / properties / documents / items / properties / completed_at / description
      Removed value: -"Completed (ISO 8601)."
    • removedOutput schema / properties / data / properties / documents / items / properties / created_at / description
      Removed value: -"Requested (ISO 8601)."
    • removedOutput schema / properties / data / properties / documents / items / properties / created_by_name / description
      Removed value: -"Who requested it."
    • removedOutput schema / properties / data / properties / documents / items / properties / due_date / description
      Removed value: -"Due date (YYYY-MM-DD)."
    • removedOutput schema / properties / data / properties / documents / items / properties / id / description
      Removed value: -"Document request id (profile_interview_document_request.id)."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / description
      Removed value: -"The documents asked for."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / description / description
      Removed value: -"Details."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / file_name / description
      Removed value: -"Uploaded file name."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / id / description
      Removed value: -"Item id (profile_interview_document_request_item.id)."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / required / description
      Removed value: -"Required."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / title / description
      Removed value: -"Document asked for."
    • removedOutput schema / properties / data / properties / documents / items / properties / items / items / properties / uploaded_at / description
      Removed value: -"Uploaded (ISO 8601)."
    • removedOutput schema / properties / data / properties / documents / items / properties / message / description
      Removed value: -"Message to the candidate."
    • removedOutput schema / properties / data / properties / documents / items / properties / position_id / description
      Removed value: -"Position (position_def_set.id)."
    • removedOutput schema / properties / data / properties / documents / items / properties / position_name / description
      Removed value: -"Position name."
    • removedOutput schema / properties / data / properties / documents / items / properties / reviewed_at / description
      Removed value: -"When a recruiter reviewed the uploads (ISO 8601)."
    • removedOutput schema / properties / data / properties / documents / items / properties / status / description
      Removed value: -"open, completed or cancelled."
    • removedOutput schema / properties / data / properties / duplicate_flag / description
      Removed value: -"Open possible duplicates (switch duplicate_detection; left out when none)."
    • removedOutput schema / properties / data / properties / duplicate_flag / properties / open_count / description
      Removed value: -"Open possible duplicates."
    • removedOutput schema / properties / data / properties / duplicate_flag / properties / top_score / description
      Removed value: -"Highest match score."
    • removedOutput schema / properties / data / properties / duplicates / description
      Removed value: -"With include=duplicates: open possible duplicates visible to you."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / duplicate_id / description
      Removed value: -"Duplicate pair id (profile_interview_duplicate.id)."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_applications / description
      Removed value: -"Its applications to positions visible to you."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_applications / items / properties / application_id / description
      Removed value: -"Application id (position_result.id)."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_applications / items / properties / position_name / description
      Removed value: -"Position name."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_applications / items / properties / status / description
      Removed value: -"Application state."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_candidate_id / description
      Removed value: -"The other candidate (profile_interview.id)."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_created_at / description
      Removed value: -"Created (ISO 8601)."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_email / description
      Removed value: -"Its e-mail."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_name / description
      Removed value: -"Its name."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / other_phone / description
      Removed value: -"Its phone number."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / reason_details / description
      Removed value: -"Each match with its value."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / reason_details / items / properties / detail / description
      Removed value: -"The matching value (the e-mail, phone, name or LinkedIn address); absent for cv and name_dob."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / reason_details / items / properties / signal / description
      Removed value: -"email, phone, name, name_dob, linkedin or cv."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / reasons / description
      Removed value: -"Which signals matched, each once: email, phone, name, name_dob, linkedin or cv."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / score / description
      Removed value: -"Match score 0 to 100."
    • removedOutput schema / properties / data / properties / duplicates / items / properties / status / description
      Removed value: -"open, dismissed or merged."
    • removedOutput schema / properties / data / properties / email / description
      Removed value: -"Contact e-mail."
    • removedOutput schema / properties / data / properties / email_auth / description
      Removed value: -"Sign-in e-mail."
    • removedOutput schema / properties / data / properties / emoji / description
      Removed value: -"Emoji marker."
    • removedOutput schema / properties / data / properties / external_id / description
      Removed value: -"Id in the company's own or ATS system."
    • removedOutput schema / properties / data / properties / id / description
      Removed value: -"Candidate id (profile_interview.id)."
    • removedOutput schema / properties / data / properties / interviews / description
      Removed value: -"Stand-alone interview results (not part of an application), newest first."
    • removedOutput schema / properties / data / properties / interviews / items / properties / created_at / description
      Removed value: -"Started (ISO 8601)."
    • removedOutput schema / properties / data / properties / interviews / items / properties / decision_reason_id / description
      Removed value: -"Decision reason id (merchant_taxonomy.id)."
    • removedOutput schema / properties / data / properties / interviews / items / properties / id / description
      Removed value: -"Interview result id (interview_result.id)."
    • removedOutput schema / properties / data / properties / interviews / items / properties / interview_id / description
      Removed value: -"Interview id (interview_def_set.id)."
    • removedOutput schema / properties / data / properties / interviews / items / properties / interview_name / description
      Removed value: -"Interview name."
    • removedOutput schema / properties / data / properties / interviews / items / properties / is_test / description
      Removed value: -"A test result."
    • removedOutput schema / properties / data / properties / interviews / items / properties / outcome / description
      Removed value: -"Outcome: pending, hired or declined."
    • removedOutput schema / properties / data / properties / interviews / items / properties / processing_status / description
      Removed value: -"Analysis state: new, processing, completed or failed."
    • removedOutput schema / properties / data / properties / interviews / items / properties / recruiter_go_next_round / description
      Removed value: -"The recruiter decision: true next round, false rejected."
    • removedOutput schema / properties / data / properties / interviews / items / properties / score / description
      Removed value: -"Score."
    • removedOutput schema / properties / data / properties / interviews / items / properties / status / description
      Removed value: -"Record state: active, draft, archived or deleted."
    • removedOutput schema / properties / data / properties / interviews / items / properties / type / description
      Removed value: -"interview, assessment, persona_interview or public_avatar."
    • removedOutput schema / properties / data / properties / is_prospect / description
      Removed value: -"Sourced and never applied (switch prospects; left out when it is off)."
    • removedOutput schema / properties / data / properties / last_login_at / description
      Removed value: -"Last sign-in (ISO 8601)."
    • removedOutput schema / properties / data / properties / linked_in / description
      Removed value: -"LinkedIn URL."
    • removedOutput schema / properties / data / properties / merchant_id / description
      Removed value: -"The company (merchant.id)."
    • removedOutput schema / properties / data / properties / mojito_language_code / description
      Removed value: -"Platform language code."
    • removedOutput schema / properties / data / properties / name / description
      Removed value: -"Name."
    • removedOutput schema / properties / data / properties / notes / description
      Removed value: -"With include=notes: up to 200 notes you can read, newest first. Another person's private note is never returned."
    • removedOutput schema / properties / data / properties / notes / items / properties / author_name / description
      Removed value: -"Author name."
    • removedOutput schema / properties / data / properties / notes / items / properties / author_profile_id / description
      Removed value: -"Author (profile.id)."
    • removedOutput schema / properties / data / properties / notes / items / properties / created_at / description
      Removed value: -"Written (ISO 8601)."
    • removedOutput schema / properties / data / properties / notes / items / properties / id / description
      Removed value: -"Note id (interview_result_comments.id or interview_result_pre_screening_comments.id)."
    • removedOutput schema / properties / data / properties / notes / items / properties / pre_screening_id / description
      Removed value: -"Pre-screening id (interview_result_pre_screening.id), for target pre_screening."
    • removedOutput schema / properties / data / properties / notes / items / properties / result_id / description
      Removed value: -"Interview result id (interview_result.id), for target result."
    • removedOutput schema / properties / data / properties / notes / items / properties / score_adjustment / description
      Removed value: -"Score adjustment of result feedback (0 for notes on the candidate)."
    • removedOutput schema / properties / data / properties / notes / items / properties / target / description
      Removed value: -"What the note is on: the candidate, an interview result or a pre-screening."
    • removedOutput schema / properties / data / properties / notes / items / properties / text / description
      Removed value: -"The note."
    • removedOutput schema / properties / data / properties / notes / items / properties / visibility / description
      Removed value: -"team: the company sees it; private: only its author."
    • removedOutput schema / properties / data / properties / owner_profile_ids / description
      Removed value: -"Recruiters owning the candidate's visible applications (profile.id; switch candidate_assignment)."
    • removedOutput schema / properties / data / properties / phone_number / description
      Removed value: -"Phone number."
    • removedOutput schema / properties / data / properties / physical_address / description
      Removed value: -"Address."
    • removedOutput schema / properties / data / properties / profile_id / description
      Removed value: -"The candidate's platform account (profile.id), when linked."
    • removedOutput schema / properties / data / properties / segments / description
      Removed value: -"With include=segments: the saved segments the candidate is in."
    • removedOutput schema / properties / data / properties / segments / items / properties / id / description
      Removed value: -"Segment id (profile_interview_segment.id)."
    • removedOutput schema / properties / data / properties / segments / items / properties / kind / description
      Removed value: -"dynamic or static."
    • removedOutput schema / properties / data / properties / segments / items / properties / name / description
      Removed value: -"Segment name."
    • removedOutput schema / properties / data / properties / skills / description
      Removed value: -"Skills read from the latest CV."
    • removedOutput schema / properties / data / properties / source_channel / description
      Removed value: -"First-touch channel (linkedin, indeed, referral, sourced, ...; untracked when unknown)."
    • removedOutput schema / properties / data / properties / status / description
      Removed value: -"Record state: active, draft or archived."
    • removedOutput schema / properties / data / properties / tags / description
      Removed value: -"Tags on the candidate."
    • removedOutput schema / properties / data / properties / tags / items / properties / color / description
      Removed value: -"Tag colour: default, accent, success, warning or danger."
    • removedOutput schema / properties / data / properties / tags / items / properties / id / description
      Removed value: -"Tag id (profile_interview_tag.id)."
    • removedOutput schema / properties / data / properties / tags / items / properties / name / description
      Removed value: -"Tag name."
    • removedOutput schema / properties / data / properties / tasks / description
      Removed value: -"With include=tasks: up to 100 tasks on the candidate you can see, open first."
    • removedOutput schema / properties / data / properties / tasks / items / properties / application_id / description
      Removed value: -"Application the task is about (position_result.id)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / assignee_name / description
      Removed value: -"Assignee name."
    • removedOutput schema / properties / data / properties / tasks / items / properties / assignee_profile_id / description
      Removed value: -"Assignee (profile.id)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / completed_at / description
      Removed value: -"Completed (ISO 8601)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / created_at / description
      Removed value: -"Created (ISO 8601)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / created_by_name / description
      Removed value: -"Who made it."
    • removedOutput schema / properties / data / properties / tasks / items / properties / definition_name / description
      Removed value: -"Name of that position or interview."
    • removedOutput schema / properties / data / properties / tasks / items / properties / due_at / description
      Removed value: -"Due (ISO 8601)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / due_state / description
      Removed value: -"overdue, today, upcoming or none."
    • removedOutput schema / properties / data / properties / tasks / items / properties / id / description
      Removed value: -"Task id (merchant_task.id)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / interview_id / description
      Removed value: -"Interview the task is about (interview_def_set.id)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / notes / description
      Removed value: -"Notes."
    • removedOutput schema / properties / data / properties / tasks / items / properties / position_id / description
      Removed value: -"Position the task is about (position_def_set.id)."
    • removedOutput schema / properties / data / properties / tasks / items / properties / status / description
      Removed value: -"open, done or cancelled."
    • removedOutput schema / properties / data / properties / tasks / items / properties / title / description
      Removed value: -"Title."
    • removedOutput schema / properties / data / properties / time_zone / description
      Removed value: -"IANA time zone."
    • removedOutput schema / properties / data / properties / unavailable / description
      Removed value: -"Sections asked for but left out because their switch is off."
    • removedOutput schema / properties / data / properties / unavailable / items / properties / section / description
      Removed value: -"The section asked for."
    • removedOutput schema / properties / data / properties / unavailable / items / properties / switch / description
      Removed value: -"The company switch that is off."
    • removedOutput schema / properties / data / properties / updated_at / description
      Removed value: -"Last changed (ISO 8601)."
  3. Changed2 schema fields changed
    • addedOutput schema / properties / data / properties / duplicates / items / properties / reason_details
      Added value: +{
      +  "description": "Each match with its value.",
      +  "items": {
      +    "properties": {
      +      "detail": {
      +        "description": "The matching value (the e-mail, phone, name or LinkedIn address); absent for cv and name_dob.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "signal": {
      +        "description": "email, phone, name, name_dob, linkedin or cv.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "signal"
      +    ],
      +    "type": "object"
      +  },
      +  "type": [
      +    "array",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / data / properties / duplicates / items / properties / reasons / description
      Previous value: -"Why the pair matched (email, phone, name, ...)."New value: +"Which signals matched, each once: email, phone, name, name_dob, linkedin or cv."
  4. Added

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive behavior, so the description's job is lighter. It still adds context the annotations do not: sections whose feature is disabled are surfaced by name in `unavailable`, and candidates are framed as decision-support material for a human reviewer — a meaningful caveat about how the output should be treated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the resource and its contents, then include behavior and the unavailable caveat, then a pointer to get_tool_reference for full argument detail. Dense but every sentence carries information; the get_tool_reference pointer is a reasonable deferral rather than bloat.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be spelled out, and the description still previews response shape and the unavailable-section behavior. For a read-only single-entity fetch with a fully documented schema, the remaining gaps (no explicit sibling routing) are minor.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description goes beyond the schema by explaining that include is a comma list adding whole lists, that omitting it yields none of them, and by introducing the `unavailable` result field, which is not derivable from the parameter docs alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific resource (one candidate, in full) and enumerates exactly what comes back: profile, applications with steps and decisions, tags and automatic tags, counts of notes/tasks/document requests/segments, and the duplicate flag. It also anchors the id to a list_candidates row, which separates it from the list tool in the sibling set.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The include parameter is explained in terms of when to add sections and the default of none, which is real usage guidance. However, it never explicitly says to prefer this over list_candidates or other get_* siblings when full detail on a single candidate is needed; that must be inferred from the enumerated contents.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.