---
title: "AI Displacement Risk Screener"
method: POST
path: "/v1/tools/ai_displacement_risk_screener"
tags: ["labor-market", "displacement-risk", "frey-osborne", "career", "workforce", "mcp:ai_displacement_risk_screener"]
---

# AI Displacement Risk Screener

`POST /v1/tools/ai_displacement_risk_screener`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/ai_displacement_risk_screener`
- Auth: none declared

Port of ApexLogics Apex #104 (AL-111) AI Displacement Risk Screener into the AINumbers chaingraph shape. From a task-composition profile (routine cognitive/manual and non-routine analytical/interpersonal/manual shares), a sector exposure factor, an education level and years in role the node computes a 0..100 composite displacement score (0.40 automation probability + 0.40 routine-task fraction + 0.20 sector exposure, clamped and rounded), an education-adjusted informational score, a Low/Medium/High/Critical tier banding, and up to three adjacent lower-exposure occupations gated at similarity >= 60. SOC lookups use an embedded 62-row table; a null SOC code estimates the probability from the sliders. Automation probabilities are Frey-Osborne 2013-vintage estimates (stale by construction), task splits are Apex-embedded approximations, and the BLS-OES-labelled median-salary cells stayed ungrounded at porting time (BLS HTTP 403): salary figures are informational only and stay out of the score. Port provenance: Apex page https://apexlogics.org/tools/104-ai-displacement-risk-screener/ fetched 2026-10-13 (sha256 68D2AA10A6B93A7E31C8E10FDDCACEFDBD661EF330951A6BF1FC25572F891D18), tasking APEXPORT-104 (GRADES PASS-PENDING-XV 2026-10-18, Builder-verifies-at-land 18/18 vectors), landed by APEX-PORT-104-LAND-1 on 2026-10-18.

**Tool URL:** https://ainumbers.co/chaingraph/art-763-ai-displacement-risk-screener.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `soc_code` string, nullable: 6-digit SOC code key into the embedded 62-row table; null selects the custom-occupation estimate branch (Apex L480-488). The only optional input.
  - `rc` integer, required: Routine Cognitive share 0..100 (slider t_rc, Apex L470; parseInt read).
  - `rm` integer, required: Routine Manual share 0..100 (slider t_rm, Apex L471; parseInt read).
  - `nra` integer, required: Non-routine Analytical share 0..100 (slider t_nra, Apex L472; parseInt read).
  - `nri` integer, required: Non-routine Interpersonal share 0..100 (slider t_nri, Apex L473; parseInt read).
  - `nrm` integer, required: Non-routine Manual share 0..100 (slider t_nrm, Apex L474; parseInt read).
  - `sector_exp` number, required: Sector exposure factor (select sector, Apex L475; parseFloat read). Apex option values 0.22..0.75.
  - `ed_level` 'no_degree' | 'associate' | 'bachelor' | 'master' | 'doctorate', required: Highest education (select edLevel, Apex L476; informational education adjustment only, Apex L499-500).
  - `years_role` integer, required: Years in role (input yearsRole, Apex L477; parseInt read; recorded, not in the arithmetic).

## Response `200`

Successful tool execution result

- object
  - `score` integer: Composite risk score 0..100 (Apex L494-496).
  - `adj_score` integer: Education-adjusted score, informational (Apex L499-500).
  - `tier` 'Low' | 'Medium' | 'High' | 'Critical': Risk tier (Apex L504-507).
  - `prob` number: Automation probability 0..1, Frey-Osborne 2013 vintage.
  - `routine_frac` number: Routine task fraction (rc+rm)/100.
  - `sector_exp` number: Echo of sector exposure input.
  - `automation_pct` integer: Rounded automation percent.
  - `routine_pct` integer: Routine task percent rc+rm.
  - `sector_pct` integer: Rounded sector percent.
  - `title` string
  - `soc` string, nullable
  - `median_salary_usd` integer, nullable: UNGROUNDED informational salary cell.
  - `alts` object[]
    - `soc` string
    - `title` string
    - `score` integer
    - `sim` integer
    - `salary_delta_vs_selected_usd` integer, nullable

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)