# Menza 2009 HIV Acquisition Risk Score for MSM (magent)

> Menza 2009 HIV Acquisition Risk Score for MSM (magent) 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-14).

Computes the Menza 2009 HIV-acquisition integer risk score for men who have sex with men (MSM) from four caller-assigned binary flags.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/menza
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/menza-2009-hiv-acquisition-risk-score-for-msm-magent-45a1f519
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mGa0euWFb8GgVW4aIgw3_

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 menza-2009-hiv-acquisition-risk-score-for-msm-magent-45a1f519
```

Example prompt: Calculate the Menza 2009 HIV acquisition score for a patient who used meth in the last 6 months, has a history of bacterial STI, had fewer than 10 male partners in the past year, and did not have unprotected anal intercourse with a positive or unknown-status partner.

## When to prefer this

Use this endpoint when you need to apply the original Menza 2009 HIV-acquisition risk scoring algorithm specifically for MSM, and you have already collected and assigned the four binary risk factors. Prefer this over HIRI-MSM or SexPro when the Menza 2009 instrument is specifically required (e.g., for research protocol fidelity or clinical workflows referencing that instrument). Do not use this endpoint to collect a sexual history, order PrEP, or make diagnostic decisions.

## Known failure modes

- Missing any of the four required boolean query parameters returns a validation error
- Non-boolean values for flag parameters cause a schema validation failure
- Network or server errors result in a non-200 HTTP status with no score returned

## How this service works

Menza 2009 HIV-acquisition score for MSM. Four caller-assigned flags: meth or poppers in the prior 6 months (11), current or prior bacterial STI (4), ≥10 male partners in the prior year (3), unprotected anal intercourse with a positive- or unknown-status partner in the prior year (1). Max 19. Integer score only; no named strata or PrEP cutoff. Not a diagnosis, PrEP order, or test-and-treat protocol. Not HIRI-MSM or SexPro. magent does not take a sexual history.

## Output

An integer between 0 and 19 representing the patient's Menza 2009 HIV-acquisition risk score for MSM, calculated as the sum of: 11 (meth/poppers), 4 (bacterial STI), 3 (≥10 male partners), and 1 (UAI with positive/unknown partner), based on the four caller-supplied boolean flags.

## 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": [
      "meth_or_poppers_6mo",
      "bacterial_sti",
      "partners_ge_10_year",
      "uai_positive_or_unknown_year"
     ],
     "properties": {
      "bacterial_sti": {
       "type": "boolean",
       "description": "Current diagnosis or history of bacterial STI (Menza 2009: gonorrhea, chlamydia, or syphilis) as assigned by the caller. true scores 4. magent does not take a sexual history."
      },
      "meth_or_poppers_6mo": {
       "type": "boolean",
       "description": "Methamphetamine or inhaled nitrites (poppers) in the prior 6 months as assigned by the caller (Menza 2009). true scores 11. magent does not take a sexual history."
      },
      "partners_ge_10_year": {
       "type": "boolean",
       "description": "Ten or more male sex partners in the prior year as assigned by the caller (Menza 2009). true scores 3. magent does not take a sexual history."
      },
      "uai_positive_or_unknown_year": {
       "type": "boolean",
       "description": "Unprotected anal intercourse with a partner of positive or unknown HIV status in the prior year as assigned by the caller (Menza 2009). true scores 1. magent does not take a sexual history."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/menza-2009-hiv-acquisition-risk-score-for-msm-magent-45a1f519/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)