get_employer_report_flow
Get the report's cohort flow
All MCP toolsRead
Start with get_employer_report_market, then read the movement here: the window-entry cohort — (person, job) pairs whose FIRST measurable funnel event falls inside the window — tracked stage by stage to today (the tracking is never window-cut). Stages with no data source yet read measurable: false with a null count — hide them, they are not zeros. rateFromPrevious is computed by the read model; null means the adjacent rate would lie (zero or exceeded previous stage). 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": {
"flow": {
"type": "object",
"properties": {
"window": {
"type": "string",
"enum": [
"m1",
"m3",
"m6"
],
"description": "Report window: \"m1\" (last 1 month, default), \"m3\", or \"m6\"."
},
"windowStart": {
"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))$"
},
"generatedAt": {
"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))$"
},
"jobs": {
"type": "array",
"items": {
"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)$"
},
"cohortSize": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Count (zero-filled)."
},
"stages": {
"minItems": 6,
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"stage": {
"type": "string",
"enum": [
"considered",
"interested",
"replied",
"applied",
"interviewing",
"offered"
],
"description": "Employer report funnel stage, in canonical order — stops at offered."
},
"measurable": {
"type": "boolean",
"description": "false = no supplier yet; hide the stage, never show 0."
},
"count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Count (zero-filled)."
},
{
"type": "null"
}
]
},
"rateFromPrevious": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
]
}
},
"required": [
"stage",
"measurable",
"count",
"rateFromPrevious"
],
"additionalProperties": false
}
}
},
"required": [
"jobId",
"cohortSize",
"stages"
],
"additionalProperties": false
}
},
"total": {
"type": "object",
"properties": {
"cohortSize": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Count (zero-filled)."
},
"stages": {
"minItems": 6,
"maxItems": 6,
"type": "array",
"items": {
"type": "object",
"properties": {
"stage": {
"type": "string",
"enum": [
"considered",
"interested",
"replied",
"applied",
"interviewing",
"offered"
],
"description": "Employer report funnel stage, in canonical order — stops at offered."
},
"measurable": {
"type": "boolean",
"description": "false = no supplier yet; hide the stage, never show 0."
},
"count": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Count (zero-filled)."
},
{
"type": "null"
}
]
},
"rateFromPrevious": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 100
},
{
"type": "null"
}
]
}
},
"required": [
"stage",
"measurable",
"count",
"rateFromPrevious"
],
"additionalProperties": false
}
}
},
"required": [
"cohortSize",
"stages"
],
"additionalProperties": false
}
},
"required": [
"window",
"windowStart",
"generatedAt",
"jobs",
"total"
],
"additionalProperties": false,
"description": "Movement: where the window-entry cohort went — per job plus the derived total (ISO datetimes)."
}
},
"required": [
"flow"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}