get_disclosure_policies
Get the stages at which the person's name and contact channels open
All MCP toolsRead
Start with this before discussing when a company gets to know the person by name or reach them: the person's own disclosure settings for the three subjects they always carry — identity (their name, and with it the full profile), email, and phone — each the stage of a pair at which that subject opens, defaults applied (identity on_match, email and phone on_scheduling). The four values are one ladder: private (never by stage), on_interview_passed, on_scheduling, on_match — each later value opens at an earlier stage of the pair. For identity, private means the name is not answered by stage — it is not secrecy, and the person still opens it by answering a sharing request. A setting answers requests and milestones that arrive AFTER it: loosening one opens nothing toward pairs that already passed the stage. phoneContactUse says whether a verified contact-use phone number is registered right now — the phone setting stands either way and governs a number registered later. Per-material settings are NOT here — read list_material_disclosures for them. Changing a setting has a tool: set_disclosure_policy.
Input schema
{
"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": "The person whose own disclosure settings to read (persons.id — self)."
}
},
"required": [
"personId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output schema
{
"type": "object",
"properties": {
"policies": {
"type": "object",
"properties": {
"identity": {
"type": "string",
"enum": [
"private",
"on_match",
"on_scheduling",
"on_interview_passed"
],
"description": "When the person's name (and with it the full profile) opens toward a pair. private means the name is not answered by stage — the person still opens it by answering a sharing request; it is not secrecy. Default on_match."
},
"email": {
"type": "string",
"enum": [
"private",
"on_match",
"on_scheduling",
"on_interview_passed"
],
"description": "When the sign-in email address opens as a contact channel. Default on_scheduling."
},
"phone": {
"type": "string",
"enum": [
"private",
"on_match",
"on_scheduling",
"on_interview_passed"
],
"description": "When the verified contact-use phone number opens as a contact channel. Default on_scheduling. The setting stands whether or not a contact-use number is registered yet — phoneContactUse says whether one is."
}
},
"required": [
"identity",
"email",
"phone"
],
"additionalProperties": false,
"description": "The folded setting per subject — the latest set value, or the default where the person never set one."
},
"phoneContactUse": {
"type": "boolean",
"description": "Whether the person has a verified phone number registered for contact use right now — the condition under which their own privacy page shows the phone row."
}
},
"required": [
"policies",
"phoneContactUse"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}