Docs
HiringRead-only annotation

Discover Candidates

discover_candidates

Match only actively opted-in candidates to an open client job. Only explicitly shared preferences affect recruiter results; private preferences affect applicant results only. Contacts stay hidden. Read required_skill_coverage, ranking_components and next_questions. Unknown skills are missing evidence, not proven inability; no automatic rejection or hiring probability claim.

Source-catalog reference. Discover the live server’s tools before calling. An annotation does not replace authorization or exact review requirements.

Parameters

NameContract
job_id
Required
string
limit
Optional
integer
cursor
Optional
string

Exact input schema

Expand JSON Schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,100}$"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "maxLength": 300
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

Output schema

Expand output contract
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {}
  },
  "required": [
    "data"
  ],
  "additionalProperties": false
}

Tool annotations

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

← All hiring tools · Review and receipts