get_market_transparency

All MCP toolsRead

The shared market snapshot both the employer and candidate reports pages show — the identical read model, no recomputation: per-currency quartiles of the annual salary published job postings advertise (each posting's upper bound, else its lower bound; monthly ranges ×12) and the median conversation reply rate, aggregated anonymously across the whole marketplace. Every caller receives the same snapshot — the read is viewer-independent by construction. The window is FIXED and lagged (it ends months before now, stated as windowStart/windowEnd in the output) — label the period; never present it as current terms. Only order statistics appear (actual data values — never sums or means), and a series below the aggregation floors is {suppressed: true} with no other field: suppression discloses nothing, and no organization- or person-identifiable figure exists at any depth. Reading writes nothing: no impressions, no notifications.

Input schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "transparency": {
      "type": "object",
      "properties": {
        "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))$"
        },
        "windowEnd": {
          "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))$"
        },
        "salary": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "suppressed": {
                  "type": "boolean",
                  "const": true
                }
              },
              "required": [
                "suppressed"
              ],
              "additionalProperties": false,
              "description": "Below the aggregation floor — no figure of any kind is disclosed."
            },
            {
              "type": "object",
              "properties": {
                "suppressed": {
                  "type": "boolean",
                  "const": false
                },
                "currencies": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "currency": {
                        "type": "string",
                        "pattern": "^[A-Z]{3}$",
                        "description": "ISO 4217 currency code (exactly three uppercase letters)."
                      },
                      "p25": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Order-statistic salary value in raw currency units — an actual posting's annual salary, never a mean."
                      },
                      "p50": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Order-statistic salary value in raw currency units — an actual posting's annual salary, never a mean."
                      },
                      "p75": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Order-statistic salary value in raw currency units — an actual posting's annual salary, never a mean."
                      },
                      "points": {
                        "type": "integer",
                        "minimum": 20,
                        "maximum": 9007199254740991,
                        "description": "Job postings published in the window that advertise an annual salary in this currency (upper bound, else lower bound; monthly ×12) — at or above the floor."
                      },
                      "orgs": {
                        "type": "integer",
                        "minimum": 5,
                        "maximum": 9007199254740991,
                        "description": "Distinct contributing organizations — at or above the floor."
                      }
                    },
                    "required": [
                      "currency",
                      "p25",
                      "p50",
                      "p75",
                      "points",
                      "orgs"
                    ],
                    "additionalProperties": false,
                    "description": "Posted-annual-salary quartiles — one currency's floored, order-statistic-only distribution of what published job postings advertise."
                  }
                }
              },
              "required": [
                "suppressed",
                "currencies"
              ],
              "additionalProperties": false
            }
          ],
          "description": "The posted-salary series: floored per-currency distributions, or suppressed."
        },
        "replyRate": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "suppressed": {
                  "type": "boolean",
                  "const": true
                }
              },
              "required": [
                "suppressed"
              ],
              "additionalProperties": false,
              "description": "Below the aggregation floor — no figure of any kind is disclosed."
            },
            {
              "type": "object",
              "properties": {
                "suppressed": {
                  "type": "boolean",
                  "const": false
                },
                "medianPct": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 100
                },
                "orgs": {
                  "type": "integer",
                  "minimum": 5,
                  "maximum": 9007199254740991,
                  "description": "Eligible organizations (≥5 in-window sends each) — at or above the floor."
                }
              },
              "required": [
                "suppressed",
                "medianPct",
                "orgs"
              ],
              "additionalProperties": false
            }
          ],
          "description": "The conversation reply-rate series: the eligible organizations' median, or suppressed."
        }
      },
      "required": [
        "windowStart",
        "windowEnd",
        "salary",
        "replyRate"
      ],
      "additionalProperties": false,
      "description": "The market going rate — anonymized shared market aggregates over a fixed lagged window."
    }
  },
  "required": [
    "transparency"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}