get_max_min_rate
NY maximum and minimum weekly benefit
The New York maximum and minimum weekly workers' compensation benefit for a date of accident (the rate year runs July 1 to June 30; the maximum is fixed by the date of accident, never by today's date). Use for "what is the max rate for a 2025 injury". New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersdate_of_accidentrequired
calculate_weekly_rate
NY weekly benefit rate (TTD, TPD, reduced earnings)
A weekly benefit rate under the NY Workers' Compensation Law: kind "total" (temporary total: two-thirds of the AWW within the max and min for the date of accident; a wage below the minimum is paid in full), "partial" (temporary partial at a degree of disability, with the same bounds) or "reduced_earnings" (two-thirds of the wage loss, capped at the max, never raised to the min). New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersawwrequiredkindrequireddate_of_accidentrequireddisability_percentcurrent_weekly_earnings
calculate_aww
NY average weekly wage (§14)
The average weekly wage from earnings in the year before the accident: earnings_method "steady" (WCL §14(1)–(2): earnings ÷ days worked × 200/260/300 for a 4-/5-/6-day week, 365 for 7) or "irregular" for new, seasonal or irregular work (§14(3)–(4): earnings ÷ weeks worked). With a date of accident it also gives the weekly rate. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersdays_workedweeks_workeddays_per_weektotal_earningsrequiredearnings_methodrequireddate_of_accident
calculate_slu_award
NY schedule loss of use (SLU) award
A schedule loss of use award for one or more scheduled members: weeks on the schedule × loss of use % × the weekly rate for the date of accident, plus any protracted healing period credit (weeks at temporary total beyond the longest healing period, §15(4-a)). With prior_payments (0 if none) it adds the money moving, the 15% attorney fee rounded down to $5 (the OC-400.1 amount) and the net. With an employer reimbursement it splits the money and the fees between claimant and employer, exact to the cent; the fee on the reimbursement comes from the claimant's money when it is enough. Optional prior-counsel fee split. No 130-week credit on SLU. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersawwrequiredbody_partsrequiredprior_paymentsdate_of_accidentrequiredprior_counsel_feesemployer_reimbursementweeks_at_temporary_total
calculate_lwec_award
NY LWEC / non-schedule PPD award
A permanent partial disability (non-schedule) award from a loss of wage-earning capacity percentage: the weekly rate (the bounded two-thirds rate × the LWEC %, kept within the max and min), the number of weeks for that LWEC bracket (§15(3)(w): 225 to 525 weeks depending on the bracket), the award, and, with the weeks of temporary benefits already paid, the credit for weeks beyond 130. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersawwrequiredlwec_percentrequireddate_of_accidentrequiredprior_temporary_weeks
calculate_ccp_award
NY award for benefit periods (CCP)
What is owed for one or more benefit periods (types TT total, TP partial with a disability %, RE reduced earnings with weekly earnings), the way The Comp Desk's CCP/Award calculator works it out: weeks from the dates (both ends count; a period starting the day the last ended counts it once; weeks rounded down to the tenth by default), each period's rate within the max and min, and the total award. With prior_payments (0 if none) it adds the claimant's money, the 15% fee exact to the cent, the OC-400.1 amount rounded down to $5 and the net; an employer reimbursement out of the whole award is split as on SLU. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersawwrequiredperiodsrequiredprior_paymentsweeks_roundingdate_of_accidentrequiredprior_counsel_feesemployer_reimbursement
calculate_section_32_split
NY Section 32 settlement split
How a Section 32 settlement divides: any Medicare set-aside comes off first, the attorney fee is 15% of the rest rounded down to $5, and the remainder is the claimant's net. Optional prior-counsel fee split (the OC-400.1 requests only the current attorney's share). The fee the Judge approves can differ. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersmsa_amountsettlement_amountrequiredprior_counsel_fees
calculate_burns_lien
NY third-party lien cost share (Burns/Kelly)
The carrier's equitable share of litigation costs on its workers' compensation lien when a third-party action recovers (WCL §29; Kelly; Burns): gross lien (indemnity + medical), the cost-share rate (attorney fee + disbursements ÷ gross recovery), the carrier's share and the net to the plaintiff. For a motor-vehicle case, give the no-fault threshold that comes off the lien first. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parametersattorney_feerequiredmedical_lienrequireddisbursementsrequiredgross_recoveryrequiredindemnity_lienrequiredmotor_vehicle_threshold
calculate_apportionment
NY SLU apportionment between claims
A schedule loss of use apportioned across two to six established claims of one claimant: each case uses its own AWW and date of accident (its own max and min) and its APPORTIONED loss of use for each member, with any protracted healing period, prior payments and credits; returns each case's award, 15% fee rounded down to $5 and net, and the totals. Cases are numbered; no names. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice.
Parameterscasesrequired
get_notice_deadline
NY notice-to-employer deadline
The date written notice of the injury to the employer is due under the NY Workers' Compensation Law, counted from the date of accident, or from the date of disablement for an occupational condition that built up over time, with the days left from today in New York and the statute it comes from. New York State only; not a substitute for checking the facts.
Parametersdate_of_accidentdate_of_disablement
lookup_formula
NY WC formula and citation
The Comp Desk's catalog of New York workers' compensation formulas (AWW, rates and bounds, SLU, LWEC, Section 32, Burns, attorney fee): the formula, what each symbol means, a plain explanation, the statutory citation, and a flag saying whether that citation has been attorney-reviewed. Pass id for one formula, query to search, or nothing for the list.
Parametersidquery
define_term
NY WC glossary term
A New York workers' compensation term from The Comp Desk glossary (AWW, SLU, LWEC, PFME, IME, ANCR, Section 32, CCP, form numbers and more): its meaning, detail, related terms and the source it comes from. Pass term for an exact entry, query to search, or nothing for the list.
Parameterstermquery
get_explainer
Plain-language NY WC explainer
A reviewed, plain-language explainer of one New York workers' compensation topic (for example AWW, SLU, ANCR), written for injured workers and usable with clients: its sentences, the definition, related terms and the official source. Only explainers approved by The Comp Desk are listed. Pass slug or term, or nothing for the list.
Parametersslug
search_wc_knowledge
NY WC knowledge base
Searches The Comp Desk's approved knowledge base of New York workers' compensation questions and answers (benefits, permanency, IMEs, Section 32, labor market attachment, Board procedure, forms), each with its citation where one exists. Returns up to 5 answers; nothing found means the approved sources do not cover it.
Parameterslimitqueryrequired
search_case_law
NY WC case law (approved library)
Searches The Comp Desk's approved library of New York workers' compensation decisions (Court of Appeals and Appellate Division), each pulled and KeyCited in Westlaw before approval: case name, citation, court, date, holding and a plain summary. Only cases returned here are backed by this source.
Parameterslimitqueryrequired
lookup_wcb_form
NY WCB form: what it is for
What a New York Workers' Compensation Board form is (for example C-3, C-4, C-4.3, RB-89, OC-400.1), from The Comp Desk's approved glossary and knowledge base, with the Board's link. A form not in those sources is reported as not covered, with the Board's forms page.
Parametersformrequired
find_providers
Find a NYC doctor for a work injury
Searches The Comp Desk's directory of medical providers in New York City's five boroughs (public CMS NPI Registry listings) by borough or ZIP code, specialty, language and whether they accept new patients. The directory is NOT the Board's authorization list: each result says to confirm the provider is WCB-authorized before booking.
Parametersziplimitboroughlanguagespecialtyaccepting_new_patients
list_skills
Hub skills (free)
The workflow skills that come with the New York State Workers' Compensation Hub (preparing cases for the Pro Workspace, explaining a benefit to a client, checking a Section 32 split, finding a WCB-authorized doctor, appeals and rebuttals, hearing prep, settlement offers, recordings, outreach and admin), with what each is for. All are free.
Takes no parameters.
The full text (SKILL.md) of one Hub skill, for people using the connector without the plugin. Call list_skills for the names.
Parametersnamerequired
describe_case_schema
Case format for the Pro Workspace
The exact case format add_workspace_cases accepts: every field of every calculator tile, the body-part names, the CCP designations, what is refused and why (statutory rates and results are derived by the workspace, never sent; unknown fields are refused by name), and two complete examples. Needs no sign-in.
Takes no parameters.
add_workspace_cases
Add cases to my Pro Workspace
Signed-in Pro or Firm attorneys only. Puts up to 25 of the attorney's cases into THEIR OWN Comp Desk Pro Workspace as finished tabs with the built-in calculator tiles (SLU, LWEC, CCP, Section 32, Burns, apportionment) filled in. Send inputs only, as facts taken from the WCB decisions and the file (claimant label, WCB number, hearing date, date of accident, the AWW found, each tile's inputs); the workspace computes every rate, award, fee and net itself. Statutory rates and results are refused by name, as is any field that does not map onto a tile. Re-sending the same case (same WCB number and hearing date) never makes a second tab. Call describe_case_schema first; afterwards get_import_status returns the figures the workspace computed.
Parameterscasesrequiredformatrequiredversionrequired
get_import_status
Import status and workspace figures
Signed-in Pro or Firm attorneys only. How the attorney's cases imported: queued (the Pro Workspace has not been opened since; it imports within a minute of opening thecompdesk.com/workspace), imported (with the figures the workspace computed), needs_review (for example the attorney edited that tab, so newer data waits for their decision) or rejected (with codes). Pass keys like "G1234567:2026-10-22" (WCB number:hearing date), or nothing for every recent import. Receipts are kept 48 hours.
Parameterskeys
calculate_slu_percent_from_rom
NY SLU % from range of motion
A schedule loss of use percentage range from measured range of motion, scored by the app's SLU range-of-motion engine (2018 NY Impairment Guidelines): each joint's deficit by severity band with proportional adjustment, the paired-motion rule (both_motions), the ankylosis cap for the body part, an optional special consideration (added or stand-alone, as the engine marks it), an optional contralateral baseline, and the shoulder muscle-atrophy finding. Joints per body part: Thumb IP/MCP/CMC (CMC is the opposition grade 1–3), Finger DIP/PIP/MCP, Wrist Palmar Flex/Dorsi Flex/Pron/Sup, Elbow Extension/Flexion, Shoulder Forward Flexion/Abduction/Int Rotation/Ext Rotation/Adduction/Post Extension, Hip Abduction/Adduction/Int Rotation/Ext Rotation/Flexion/Post Extension, Knee Flexion/Extension, Ankle/Foot Plantar Flex/Dorsi Flex/Inversion/Eversion, Great Toe IP/MTP Flex/MTP Ext, Smaller Toes DIP/PIP/MTP. Returns a percentage, not an award: pass the percentage to calculate_slu_award. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersbody_partrequiredboth_motionsmeasurementsrequiredcontralateralspecial_considerationshoulder_muscle_atrophy
calculate_slu_joint_replacement
NY SLU % for a joint replacement
The schedule loss of use percentage for a shoulder, hip or knee replacement on its own scoring track (2018 NY Impairment Guidelines Tables 5.5 / 6.5 / 7.5, as the app's engine encodes them): the base, plus the value that most closely matches the deficit in each column (range of motion, position, atrophy, chronic complications), up to the table maximum. A failed replacement is reported as not schedulable. Shoulder takes flexion/abduction; hip takes flexion, leg-length discrepancy, mal-rotation, hip_fracture; knee takes flexion, extension contracture, malalignment, ML laxity, AP motion, leg length. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersjointrequiredfailedap_motion_mmhip_fractureatrophy_inchesmonths_post_opflexion_degreesabduction_degreesml_laxity_degreesmal_rotation_degreesmalalignment_degreeschronic_complications+2 more
calculate_benefit_weeks
NY benefit weeks between dates
Weeks between dates the way The Comp Desk's CCP / Award calculator counts them: both end dates count; a period that starts the day the previous one ended counts that day once; a period held in abeyance counts no weeks; weeks rounded down to none / tenth / whole. Returns per period the inclusive days, exact and rounded weeks, whether the shared boundary day was dropped, and the next day after the end. Dates only, no money. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersperiodsrequiredweeks_rounding
calculate_fee_split
NY attorney fee split with prior counsel
Divides an attorney fee between the current attorney and one or two prior counsel the way every Comp Desk tile does: each prior counsel gets the dollar amount given, the current attorney the rest, worked in whole cents; prior amounts above the fee are flagged as over-allocated (nothing can be requested). Also gives the OC-400.1 amount: the current attorney's share rounded down to the nearest $5. The fee the Board approves can differ. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parameterstotal_feerequiredprior_counsel_feesrequired
calculate_aww_with_adjustments
NY average weekly wage with tips, board and concurrent wages
The average weekly wage the way the Pro Workspace's global AWW works it out: earnings_method "steady" (earnings ÷ days worked × the 200/260/300/365 multiplier for a 4-/5-/6-/7-day week ÷ 52) or "irregular" (earnings ÷ weeks worked), plus weekly tips, the weekly value of board, and a concurrent employer's weekly wage. With a date of accident it adds the two-thirds weekly rate within the max and min. For a 1–3 day week use calculate_aww. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersdays_workedweekly_tipsweekly_boardweeks_workeddays_per_weektotal_earningsrequiredearnings_methodrequireddate_of_accidentconcurrent_weekly_wage
rank_radiculopathy
NY radiculopathy severity rank
The cervical or lumbar radiculopathy severity ranking, scored the way the Pro Workspace Radiculopathy tile scores it, from the 2012 NYS Impairment Guidelines tables as calc-core carries them: imaging 16, EMG 6, muscle weakness by grade (0–1: 20, 2: 18, 3: 6, 4–5: 0) plus atrophy 6 under the root's weakness cap, sensory (compromised 4, anesthesia 6) under the root's sensory cap, reflex (diminished 4, absent 6), tension signs 4; the letter from Table S11.7. Give the findings (unlisted findings count as normal / no), or instead total_points to rank a total already scored. A total with no row on Table S11.7 (1–3 points, or above the top row) is refused with the reason, never given a letter. Cervical roots C5–T1, lumbar L3–S1. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersemgreflexregionrequiredimagingsensorynerve_roottotal_pointstension_signsmuscle_atrophymuscle_weakness_grade
calculate_ccp_award_detailed
NY award for benefit periods, full CCP engine
The full Pro Workspace CCP / Award engine: periods of type TT (total), RE (reduced earnings, with current weekly earnings), TR / TP (a disability percentage of two-thirds of the wage, or a typed weekly rate), NCLT / NME ($0) and HIA (held in abeyance, no weeks); weeks counted with both ends, the shared boundary day once, rounded down to none / tenth / whole (default tenth); each rate within the max and min for the date of accident (RE capped, never raised); an amending period paid at its rate less a prior percentage or prior weekly rate; already-paid periods kept in the award but out of the money moving and fee; employer reimbursements per period with scope "period", "all" or a "specific" date range (or amount unknown); the CCP fee (the weekly CCP amount ÷ 3); prior payments; and the prior-counsel split. Returns every period, the award, the exact fee, the OC-400.1 amount rounded down to $5 and both nets. calculate_ccp_award is the simpler TT/TP/RE version. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice.
Parametersawwrequiredperiodsrequiredprior_paymentsweeks_roundingdate_of_accidentrequiredccp_weekly_amountprior_counsel_fees
list_hearing_notes
My hearing notes waiting to be posted
Signed-in Pro or Firm attorneys only. Lists the hearing notes the attorney formatted in THEIR OWN Comp Desk Pro Workspace and sent with "Post Hearing Notes in Case Management OS via Claude" (drafts never appear): for each, the id, case label, WCB number, hearing date, purpose, WCLJ, WCB status (HS / NFA / FTP), the system the attorney chose, how many to-dos it has, the next date, and whether it is queued or already posted. Newest hearing first. Call it to find the notes to post, then get_hearing_note for each. Notes are client-confidential: use them only for that entry.
Parameterstofromlimitstatus
get_hearing_note
One hearing note, ready to post
Signed-in Pro or Firm attorneys only. One hearing note from the attorney's own Pro Workspace: the structured record (hearing date, time and purpose; WCLJ; carrier counsel; body parts with their status such as ANCR or PFME; the WCLJ outcome lines as written; awards: periods, AWW, CCP, attorney fee, classification; WCB status; client testified; depositions; adjournment and next date; to-dos with owners and deadlines, with any HIPAA details; documents to file; notes; the attorney's own sections), the narrative exactly as the attorney approved it, and a field-mapping hint for their case-management system (Litify, Clio, MyCase, Filevine, Smokeball, CASEpeer, Needles, PracticePanther or another). The hint names common places, not the attorney's actual fields: match it to what their system shows, show the attorney a preview and ask before writing anything. Never fill a field the note does not have.
Parametersidrequiredtarget_system
mark_hearing_note_posted
Mark a hearing note posted
Signed-in Pro or Firm attorneys only. After the note is in the attorney's case-management system AND the attorney has confirmed it, marks that queued note posted in their Pro Workspace (status entered, by Claude), with the system and an optional reference (for example the matter or note id). Changes nothing else: the note's text and record stay as the attorney wrote them. A draft, a note already posted, or a note that is not theirs is not touched.
Parametersidrequiredsystemrequiredexternal_ref