get_employer_report_events

All MCP toolsRead

Start with get_employer_report_market; this companion read returns the in-window dated events for the same selection, newest first: posting published (the moment from which the hiring team's writes on that job pass — nothing separate marks it), conversations engaged, first replies, selection records opened (applied), and pipeline transitions (declined/withdrawn carry bad: true). items is capped at 20 while totalCount is the uncapped in-window total. A null candidateName or deciderName means that person has been erased. These are the same numbers the web /report page shows (the identical read model — no recomputation). Reading writes nothing: no impressions, no notifications.

Input schema

{
  "type": "object",
  "properties": {
    "jobIds": {
      "minItems": 1,
      "maxItems": 500,
      "type": "array",
      "items": {
        "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": "Selected job ids (1..500, unique). Unknown, cross-organization, and UNPUBLISHED ids are silently dropped (fail-closed) — find the organization's published postings with list_job_postings first. There is no all-jobs default: pass every id you want counted."
    },
    "window": {
      "description": "Report window (m1 / m3 / m6); omitted = m1 — the same default the web report uses.",
      "type": "string",
      "enum": [
        "m1",
        "m3",
        "m6"
      ]
    },
    "timeZone": {
      "description": "IANA time zone the window boundary is interpreted in; omitted = \"UTC\". When you need the same numbers a human sees on their report, pass that viewer's time zone.",
      "type": "string"
    }
  },
  "required": [
    "jobIds"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "events": {
      "type": "object",
      "properties": {
        "items": {
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "published",
                  "interested",
                  "replied",
                  "applied",
                  "transition"
                ],
                "description": "Dated employer report event kind (v1 closed vocabulary)."
              },
              "occurredAt": {
                "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))$"
              },
              "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)$"
              },
              "candidateName": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "deciderName": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "toState": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "applied",
                      "screening_passed",
                      "interviewing",
                      "offered",
                      "accepted",
                      "converted",
                      "withdrawn",
                      "declined"
                    ],
                    "description": "Candidacy state: the active pipeline \"applied\" → \"screening_passed\" → \"interviewing\" → \"offered\" → \"accepted\" → \"converted\", plus the terminal negatives \"withdrawn\" (seeker-initiated) and \"declined\" (hirer-initiated)."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bad": {
                "type": "boolean"
              }
            },
            "required": [
              "kind",
              "occurredAt",
              "jobId",
              "candidateName",
              "deciderName",
              "toState",
              "bad"
            ],
            "additionalProperties": false
          }
        },
        "totalCount": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Count (zero-filled)."
        }
      },
      "required": [
        "items",
        "totalCount"
      ],
      "additionalProperties": false,
      "description": "Dated events: the in-window merged timeline across the selected jobs (ISO datetimes)."
    }
  },
  "required": [
    "events"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}