list_talent_pool_members
List talent-pool members
All MCP toolsRead
One pool's members, most recently added first: the card projection (no contact fields; intent only while the candidate is open to work), membership provenance (manual), contact state, and the organization-level evaluation (grade S/A/B + one-line note; null when never evaluated). Every returned member is logged as an impression. Paginated by keyset cursor: pass the returned nextCursor as the next call's cursor to continue; null nextCursor = the final page.
Input schema
{
"type": "object",
"properties": {
"poolId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The pool to list (from list_talent_pools)."
},
"limit": {
"description": "Page size, 1..50 (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"cursor": {
"description": "Opaque continuation token — the previous page's nextCursor. Omit for the first page.",
"type": "string",
"minLength": 1
}
},
"required": [
"poolId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output schema
{
"type": "object",
"properties": {
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"personId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "persons.id — pass to the profile/evaluation tools."
},
"personToken": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Opaque subject_token — the impressions itemRef, never PII (ADR-0064)."
},
"source": {
"type": "string",
"enum": [
"manual"
],
"description": "Membership provenance: manual (a human's own add)."
},
"addedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "When the membership was created (ISO 8601, UTC)."
},
"contacted": {
"type": "boolean",
"description": "True when the person has any job-subject thread participation in the organization."
},
"card": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The candidate's display name under the consent fold (ADR-0200): the real name only under an active full grant; the stable pseudonymous handle otherwise."
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "The profile's verbatim skill names."
},
"desiredLocations": {
"description": "Desired locations (country and/or region codes) when the profile declares them.",
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166-1 alpha-2 country code: exactly two uppercase letters, e.g. \"JP\". Three-letter codes (\"JPN\"), subdivision codes (\"JP-13\"), country names, and lowercase are rejected."
},
{
"type": "string",
"pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$",
"description": "ISO 3166-2 subdivision code: two uppercase letters, a hyphen, then 1-3 uppercase alphanumerics, e.g. \"JP-13\" (Tokyo). Country-only codes (\"JP\"), place names, and lowercase are rejected."
}
],
"description": "Desired-location entry: a whole country as an ISO 3166-1 alpha-2 code (e.g. \"US\") or one region as an ISO 3166-2 subdivision code (e.g. \"JP-13\"). Names, lowercase, and three-letter codes are rejected."
}
},
"desiredSalaries": {
"description": "The per-currency desired-salary rows the profile resolves to (annual lower bounds); absent when the profile states none.",
"type": "array",
"items": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code (exactly three uppercase letters). Required — no default."
},
"min": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Desired annual lower bound in raw currency units (non-negative integer). Required — a row without a lower bound does not exist in the contract."
},
"max": {
"description": "Optional annual upper bound in raw currency units; the posting↔row match never reads it, while the shared internal candidate facet fold reads it as the row's upper bound. Must be >= min when present.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"unit": {
"default": "YEAR",
"description": "Salary period unit; rows are always annual (\"YEAR\").",
"type": "string",
"const": "YEAR"
}
},
"required": [
"currency",
"min",
"unit"
],
"additionalProperties": false,
"description": "One per-currency desired-salary lower-bound row (annual): matching is strict against postings in this row's currency only — never converted, never compared across currencies."
}
},
"intent": {
"description": "Present only while the person's openToWork is on (ADR-0084).",
"type": "object",
"properties": {
"mobility": {
"description": "Mobility — one of the ordered MOBILITY_LEVELS (3 levels).",
"type": "string"
},
"sideJobDesire": {
"type": "string",
"enum": [
"not_open",
"open"
],
"description": "Side-job desire: \"open\" or \"not_open\". Orthogonal to mobility."
},
"availability": {
"type": "object",
"properties": {
"earliestStartDate": {
"type": "string",
"pattern": "^[1-2]\\d{3}(-[0-1]\\d(-[0-3]\\d)?)?$",
"description": "Earliest start date as ISO 8601 with optional month/day, e.g. \"2026-10\" or \"2026-10-01\"."
},
"weeklyHours": {
"description": "Available hours per week as a positive integer.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"additionalProperties": false,
"description": "Availability window: earliest start date and weekly available hours (both optional)."
}
},
"additionalProperties": false
}
},
"required": [
"name",
"skills"
],
"additionalProperties": false,
"description": "The card projection — facet-relevant fields, no contact data."
},
"evaluation": {
"anyOf": [
{
"type": "object",
"properties": {
"grade": {
"anyOf": [
{
"type": "string",
"enum": [
"S",
"A",
"B"
],
"description": "Candidate evaluation grade: S | A | B (S = most want to meet). No C grade — declined owns rejection."
},
{
"type": "null"
}
],
"description": "The grade (S | A | B), or null when ungraded."
},
"note": {
"type": "string",
"maxLength": 2000,
"description": "The one-line note — the reason for the grade, read by whoever requested the evaluation. Erasable free text, never captured; stored ceiling 2000 chars (legacy memos + folded sticky labels), changed values are capped at 300 on write."
},
"updatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "When the evaluation last changed (ISO 8601, UTC)."
}
},
"required": [
"grade",
"note",
"updatedAt"
],
"additionalProperties": false,
"description": "One organization-level candidate evaluation: grade (S/A/B, nullable) + the one-line note + updatedAt."
},
{
"type": "null"
}
],
"description": "The organization-level evaluation; null when never evaluated."
}
},
"required": [
"personId",
"personToken",
"source",
"addedAt",
"contacted",
"card",
"evaluation"
],
"additionalProperties": false,
"description": "One talent-pool member entry with card projection and evaluation state."
},
"description": "One page of members, added desc."
},
"nextCursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Pass as the next call's cursor to continue; null on the final page."
}
},
"required": [
"members",
"nextCursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}