# magent VExUS Grader (Beaubien-Souligny 2020)

> magent VExUS Grader (Beaubien-Souligny 2020) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Computes VExUS grade (0–3) from caller-supplied IVC dilation status and hepatic, portal, and intra-renal Doppler grades using the Beaubien-Souligny 2020 criteria.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/vexus
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/magent-vexus-grader-beaubien-souligny-2020-5e7400c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MX6FEdqIFzXEl4Ruup5i5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability magent-vexus-grader-beaubien-souligny-2020-5e7400c9
```

Example prompt: Calculate the VExUS grade for a patient whose IVC is dilated (≥2 cm), hepatic vein Doppler is severe, portal vein is mild, and intra-renal Doppler is normal.

## When to prefer this

Use this endpoint when you have already performed point-of-care ultrasound and assigned Doppler grades yourself and need the official Beaubien-Souligny 2020 VExUS C grading logic applied instantly and consistently. Prefer this over manual lookup when embedding VExUS scoring in clinical decision-support agents, documentation tools, or research pipelines. Not appropriate if you need to perform ultrasound interpretation, diagnose AKI, or use VExUS variants A, B, D, or E.

## Known failure modes

- Missing required query parameters (ivc_dilated, hepatic, portal, renal) returns a 400-level error
- Invalid enum values for hepatic, portal, or renal (anything other than 'normal', 'mild', 'severe') cause validation failure
- Non-boolean value for ivc_dilated causes a parameter error
- Payment not included or insufficient USDC causes a 402 Payment Required response

## How this service works

Beaubien-Souligny 2020 VExUS C only (not A, B, D, or E). Caller-assigned ivc_dilated (IVC ≥2 cm) plus hepatic, portal, and intra-renal Doppler each normal, mild, or severe. Grade 0 if the IVC is not dilated; 1 if dilated with zero severe patterns; 2 if exactly one severe; 3 if two or more are severe. magent does not perform ultrasound. Not an AKI diagnosis or a fluid-order. Not a medical device.

## Output

Returns a VExUS grade integer (0, 1, 2, or 3): 0 if IVC is not dilated; 1 if IVC is dilated with no severe Doppler patterns among hepatic, portal, and renal; 2 if exactly one of those three is severe; 3 if two or more are severe.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ivc_dilated",
      "hepatic",
      "portal",
      "renal"
     ],
     "properties": {
      "renal": {
       "enum": [
        "normal",
        "mild",
        "severe"
       ],
       "type": "string",
       "description": "Intra-renal venous Doppler grade as assigned by the caller (Beaubien-Souligny 2020 Figure 1): normal (continuous flow); mild (discontinuous with a systolic and a diastolic phase); severe (discontinuous with only a diastolic phase during the cardiac cycle). magent does not perform ultrasound."
      },
      "portal": {
       "enum": [
        "normal",
        "mild",
        "severe"
       ],
       "type": "string",
       "description": "Portal-vein Doppler grade as assigned by the caller (Beaubien-Souligny 2020 Figure 1 caption): normal (pulsatility fraction not in the mild or severe bands); mild (velocity variation 30 to <50%); severe (variation ≥50%). magent does not perform ultrasound."
      },
      "hepatic": {
       "enum": [
        "normal",
        "mild",
        "severe"
       ],
       "type": "string",
       "description": "Hepatic-vein Doppler grade as assigned by the caller (Beaubien-Souligny 2020 Figure 1): normal (not mild and not severe; triphasic S > D toward the liver); mild (S component lower in magnitude than D but still toward the liver); severe (S component reversed, toward the heart). magent does not perform ultrasound."
      },
      "ivc_dilated": {
       "type": "boolean",
       "description": "Whether the IVC is dilated as assigned by the caller. Dilated iff maximal IVC diameter ≥2 cm (Beaubien-Souligny 2020). true or false. Grade 0 whenever this is false, regardless of Doppler. magent does not measure IVC."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-vexus-grader-beaubien-souligny-2020-5e7400c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)