get_job_brief

Get a job's private brief

All MCP toolsRead

Read the PRIVATE per-job brief the hiring team keeps for its agent: whom to meet, what makes them decline, the real salary latitude beyond the advertised range, and what to emphasise about this job. This is the organization's own judgment material — it is never published, never matched, and never shown to candidates. null means no brief has been written yet; ask the team to fill it in via save_job_brief or the web editor.

Input schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "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 job whose brief to read (jobs.id)."
    }
  },
  "required": [
    "jobId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "jobId": {
      "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)$"
    },
    "brief": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "meetCriteria": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 10000
                },
                {
                  "type": "null"
                }
              ],
              "description": "Meet criteria — free text or null."
            },
            "declineCriteria": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 10000
                },
                {
                  "type": "null"
                }
              ],
              "description": "Decline criteria — free text or null."
            },
            "salaryLatitude": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 10000
                },
                {
                  "type": "null"
                }
              ],
              "description": "Salary latitude — free text or null."
            },
            "talkingPoints": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 10000
                },
                {
                  "type": "null"
                }
              ],
              "description": "Talking points — free text or null."
            }
          },
          "required": [
            "meetCriteria",
            "declineCriteria",
            "salaryLatitude",
            "talkingPoints"
          ],
          "additionalProperties": false,
          "description": "Per-job private brief as stored (strict): four nullable free-text fields. Agent-only judgment material — never a publication, matching, or display input."
        },
        {
          "type": "null"
        }
      ],
      "description": "The stored brief, or null when nothing has been saved for this job yet."
    }
  },
  "required": [
    "jobId",
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

On this page