# NVPS (Odhner) NVPS Status: LIVE Price: $0.005 USDC `GET /api/calc/nvps` HTML: https://magentlab.com/docs/nvps Markdown: https://magentlab.com/docs/nvps.md Not a medical device. Not a diagnosis, dose, or listing recommendation. ## What it computes Sum five caller-assigned Odhner 2003 original NVPS integers (0-2) and return the published total (max 10). ## When to use When an agent has already assigned Odhner 2003 original 0-2 integers for face, activity, guarding, physiologic I (vital signs), and physiologic II (autonomic) and needs the published total, not a pain diagnosis, analgesic order, later NVPS-R respiratory category, or invented intensity cutoff. ## When not to use - Not a medical device and not a pain diagnosis or analgesic order. - Each of the five items is a caller-assigned integer 0, 1, or 2 from Odhner 2003. magent does not observe the patient. - Original Odhner 2003 NVPS only. Not the later NVPS-R that replaces physiologic II with a respiratory category. - Total is 0-10. magent does not add mild, moderate, or severe intensity cutoffs that are not in Odhner 2003. - Not BPS. Not FLACC. ## Formula ``` NVPS = face + activity + guarding + physiologic_i + physiologic_ii; each caller-assigned 0-2; max 10 ``` ## Citation [Assessing pain control in nonverbal critically ill adults](https://doi.org/10.1097/00003465-200311000-00010) Odhner M, Wegman D, Freeland N, Steinmetz A, Ingersoll GL Dimens Crit Care Nurs. 2003;22(6):260-267 DOI: [10.1097/00003465-200311000-00010](https://doi.org/10.1097/00003465-200311000-00010) ## Worked example ### All items 0 Given: `activity=0, face=0, guarding=0, physiologic_i=0, physiologic_ii=0` 1. face 0 + activity 0 + guarding 0 + physiologic_i 0 + physiologic_ii 0 2. Score = 0 (max 10) ### All items 2 Given: `activity=2, face=2, guarding=2, physiologic_i=2, physiologic_ii=2` 1. face 2 + activity 2 + guarding 2 + physiologic_i 2 + physiologic_ii 2 2. Score = 10 (max 10) ## Also searched as - NVPS - Nonverbal Pain Scale - Odhner NVPS - original NVPS - Adult Nonverbal Pain Scale - nonverbal critically ill adults pain - Odhner 2003 NVPS - NVPS original not NVPS-R ## Parameters - `face` (integer, required): Caller-assigned Odhner 2003 original NVPS face (integer 0-2): 0 no particular expression or smile; 1 occasional grimace, tearing, frowning, wrinkled forehead; 2 frequent grimace, tearing, frowning, wrinkled forehead. magent does not observe the patient. - `activity` (integer, required): Caller-assigned Odhner 2003 original NVPS activity/movement (integer 0-2): 0 lying quietly, normal position; 1 seeking attention through movement or slow, cautious movement; 2 restless, excessive activity and/or withdrawal reflexes. magent does not observe the patient. - `guarding` (integer, required): Caller-assigned Odhner 2003 original NVPS guarding (integer 0-2): 0 lying quietly, no positioning of hands over areas of the body; 1 splinting areas of the body, tense; 2 rigid, stiff. magent does not observe the patient. - `physiologic_i` (integer, required): Caller-assigned Odhner 2003 original NVPS physiologic I vital signs (integer 0-2): 0 stable vital signs (no change in past 4 h vs baseline BP/HR/RR); 1 change over past 4 h in SBP >20 mmHg or HR >20/min or RR >10/min; 2 change over past 4 h in SBP >30 mmHg or HR >25/min or RR >20/min. magent does not observe the patient. - `physiologic_ii` (integer, required): Caller-assigned Odhner 2003 original NVPS physiologic II autonomic (integer 0-2): 0 warm, dry skin; 1 dilated pupils, perspiring, flushing; 2 diaphoretic, pallor. Not the later NVPS-R respiratory category. magent does not observe the patient. ## Bulk (POST) POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement. Method: `POST /api/calc/nvps` Max items: 25 Price: unit_amount + extra_item_amount * (n - 1) (unit 5000 atomic, extra 2000 atomic) Status: PREVIEW - 1 to 25 items. Each item uses the same keys as the GET query parameters. - POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows. - The first invalid item fails the whole request (index in the 400 JSON). You are not charged. - HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row. - Catalog misses (empty matches, found=false) stay paid 200s inside that slot. - x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items. Example request: ```json { "items": [ { "activity": "0", "face": "0", "guarding": "0", "physiologic_i": "0", "physiologic_ii": "0" }, { "activity": "0", "face": "0", "guarding": "0", "physiologic_i": "0", "physiologic_ii": "0" } ] } ``` Human paywall (two-item fixture): https://api.magentlab.com/paywall/bulk/nvps Example 200: ```json { "count": 2, "path": "/api/calc/nvps", "items": [ { "components": [ { "value": 0, "factor": "face", "points": 0, "present": true }, { "value": 0, "factor": "activity", "points": 0, "present": true }, { "value": 0, "factor": "guarding", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_i", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_ii", "points": 0, "present": true } ], "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Odhner M, Wegman D, Freeland N, Steinmetz A, Ingersoll GL", "doi": "10.1097/00003465-200311000-00010", "id": "odhner-2003", "pmid": "14639117", "source": "Dimens Crit Care Nurs. 2003;22(6):260-267", "title": "Assessing pain control in nonverbal critically ill adults" }, "formula": "nvps", "formula_expression": "NVPS = face + activity + guarding + physiologic_i + physiologic_ii; each caller-assigned 0-2; max 10", "max_score": 10, "score": 0, "activity": 0, "face": 0, "guarding": 0, "physiologic_i": 0, "physiologic_ii": 0 }, { "components": [ { "value": 0, "factor": "face", "points": 0, "present": true }, { "value": 0, "factor": "activity", "points": 0, "present": true }, { "value": 0, "factor": "guarding", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_i", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_ii", "points": 0, "present": true } ], "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Odhner M, Wegman D, Freeland N, Steinmetz A, Ingersoll GL", "doi": "10.1097/00003465-200311000-00010", "id": "odhner-2003", "pmid": "14639117", "source": "Dimens Crit Care Nurs. 2003;22(6):260-267", "title": "Assessing pain control in nonverbal critically ill adults" }, "formula": "nvps", "formula_expression": "NVPS = face + activity + guarding + physiologic_i + physiologic_ii; each caller-assigned 0-2; max 10", "max_score": 10, "score": 0, "activity": 0, "face": 0, "guarding": 0, "physiologic_i": 0, "physiologic_ii": 0 } ] } ``` ## Response fields - `formula` (string): nvps - `formula_expression` (string): Exact expression used - `score` (integer): NVPS points 0-10 - `max_score` (integer): Always 10 - `face` (integer): Caller-assigned face points 0-2 - `activity` (integer): Caller-assigned activity points 0-2 - `guarding` (integer): Caller-assigned guarding points 0-2 - `physiologic_i` (integer): Caller-assigned physiologic I (vital signs) points 0-2 - `physiologic_ii` (integer): Caller-assigned physiologic II (autonomic) points 0-2 - `components` (array): Per-item caller-assigned points - `citation` (object): Odhner et al. Dimens Crit Care Nurs 2003 citation - `disclaimer` (string): Not-a-device notice ## Example JSON Frozen fixture. Not a live lookup. ```json { "components": [ { "value": 0, "factor": "face", "points": 0, "present": true }, { "value": 0, "factor": "activity", "points": 0, "present": true }, { "value": 0, "factor": "guarding", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_i", "points": 0, "present": true }, { "value": 0, "factor": "physiologic_ii", "points": 0, "present": true } ], "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.", "citation": { "authors": "Odhner M, Wegman D, Freeland N, Steinmetz A, Ingersoll GL", "doi": "10.1097/00003465-200311000-00010", "id": "odhner-2003", "pmid": "14639117", "source": "Dimens Crit Care Nurs. 2003;22(6):260-267", "title": "Assessing pain control in nonverbal critically ill adults" }, "formula": "nvps", "formula_expression": "NVPS = face + activity + guarding + physiologic_i + physiologic_ii; each caller-assigned 0-2; max 10", "max_score": 10, "score": 0, "activity": 0, "face": 0, "guarding": 0, "physiologic_i": 0, "physiologic_ii": 0 } ``` ## Errors - HTTP 400 `invalid_nvps`: NVPS inputs must be the five caller-assigned 0-2 Odhner 2003 original categories (face, activity, guarding, physiologic_i, physiologic_ii). Returned before settlement; you are not charged. - HTTP 400 `invalid_items`: POST body must be a JSON object with only an items array Returned before settlement; you are not charged. - HTTP 400 `invalid_item_count`: items must be an array of 1 to 25 objects Returned before settlement; you are not charged. - HTTP 400 `invalid_item`: each items entry must be a JSON object Returned before settlement; you are not charged. Shared HTTP 402 and 503: https://magentlab.com/docs/payments ## Related tools - [BPS](https://magentlab.com/docs/bps) — Sum three caller-assigned Payen 2001 BPS integers (1-4) and return the published total (range 3-12). - [FLACC](https://magentlab.com/docs/flacc) — Sum five caller-assigned Merkel 1997 FLACC integers (0-2) and return the published total (max 10). ## Payment Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. - GET the tool with Accept: application/json (do not send Accept: text/html unless you want the human paywall). - HTTP 402 means you have not paid. Decode the base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote. - Sign accepts[0] (exact, EIP-3009) with validBefore = now + maxTimeoutSeconds (600 seconds), or accepts[1] (batch-settlement deposit/voucher) on product GET. Ping and POST {items} stay exact. Magent retries transient facilitator 429/5xx before answering. - Retry the same URL with PAYMENT-SIGNATURE (base64 JSON of accepted and payload). Magent attaches canonical extensions.bazaar on CDP verify/settle; echoing 402 bazaar is optional. - Success is HTTP 200 JSON plus PAYMENT-RESPONSE. exact settles before the tool. batch-settlement verifies (and deposit-settles) before the tool and commits the charge after HTTP 2xx. HTTP 503: retry the same PAYMENT-SIGNATURE. Mint a new exact nonce only after a new HTTP 402. - offered `exact` on eip155:8453: Fixed-price USDC on Base. The buyer authorizes the advertised amount (EIP-3009). magent settles before the tool runs (paymentFlow upfront). extra.assetTransferMethod=eip3009 extra.paymentFlow=upfront. - offered `batch-settlement` on eip155:8453: Payment-channel vouchers claimed later in batches. Exact stays accepts[0]. Same-path POST {items} is still exact. extra.assetTransferMethod=eip3009 extra.paymentFlow=authorization. - not offered `upto`: Not offered. Usage-based: buyer authorizes a ceiling, seller settles the actual amount after work. Reserved for a future metered tool. Not for current calculators or code search. Same-path POST {items} is still scheme exact: one EIP-3009 authorization for GET unit plus $0.002 per extra item. That is not x402 batch-settlement (payment channels / vouchers). Shared HTTP 402 and 503 table: https://magentlab.com/docs/payments Stdio MCP (one process per host): https://magentlab.com/docs/mcp ## Guarantees - HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON. - exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE. - HTTP 402 is unpaid only. Do not sign a second authorization because of a 503. - Execution is timeout-bounded and concurrency-capped. - Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.