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
}

On this page