{"uid":"cap_X7pA9yIcGM-MUAz-04B9d","slug":"magent-hiri-msm-hiv-incidence-risk-index-calculator-d8d6ab72","name":"magent HIRI-MSM HIV Incidence Risk Index Calculator","description":"Smith 2012 seven-item HIV incidence risk index for MSM. Age 18-28=8, 29-40=5, 41-48=2, >=49=0; male partners 0-5=0, 6-10=4, >=11=7; HIV-positive partners 0=0, 1=4, >=2=8; unprotected receptive anal 0=0, >=1=10; insertive anal with HIV-positive partner 0-4=0, >=5=6; poppers 3; amphetamines 5. Range 0-47; at_or_above_10 when score >=10. Caller-assigned. Not a diagnosis or PrEP order.","url":"https://api.magentlab.com/api/calc/hiri_msm","method":"GET","headers":{},"bodySchema":{"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":["age","male_sex_partners_6mo","hiv_positive_male_partners_6mo","unprotected_receptive_anal_6mo","insertive_anal_hiv_positive_6mo","poppers_6mo","amphetamines_6mo"],"properties":{"age":{"type":"integer","description":"Age in years (18-120). Smith 2012: 18-28 scores 8; 29-40 scores 5; 41-48 scores 2; ≥49 scores 0. Caller-assigned. magent does not take a sexual history."},"poppers_6mo":{"type":"boolean","description":"Caller-assigned popper (amyl nitrate) use in the prior 6 months (Smith 2012). true or false. magent does not take a substance-use history."},"amphetamines_6mo":{"type":"boolean","description":"Caller-assigned amphetamine use in the prior 6 months (Smith 2012). true or false. magent does not take a substance-use history."},"male_sex_partners_6mo":{"type":"integer","description":"Caller-assigned number of male sex partners in the prior 6 months (0-500). Smith 2012: 0-5 scores 0; 6-10 scores 4; ≥11 scores 7."},"hiv_positive_male_partners_6mo":{"type":"integer","description":"Caller-assigned number of HIV-positive male sex partners in the prior 6 months (0-500). Smith 2012: 0 scores 0; 1 scores 4; ≥2 scores 8. Do not drop this item."},"unprotected_receptive_anal_6mo":{"type":"integer","description":"Caller-assigned times the person had unprotected receptive anal sex with a male partner of any HIV status in the prior 6 months (0-500). Smith 2012: 0 scores 0; ≥1 scores 10."},"insertive_anal_hiv_positive_6mo":{"type":"integer","description":"Caller-assigned times the person had insertive anal sex with an HIV-positive male partner in the prior 6 months (0-500). Smith 2012: 0-4 scores 0; ≥5 scores 6."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_urZ3f8NFORcwJJoq1gEo_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Smith 2012 seven-item HIV Incidence Risk Index for Men who have Sex with Men (HIRI-MSM), returning a total score (0–47) and a binary high-risk flag (at_or_above_10) based on caller-supplied behavioral and demographic inputs.","exampleAgentPrompt":"Calculate the Smith 2012 HIRI-MSM HIV risk score for a 32-year-old man who had 8 male sex partners in the last 6 months, 1 HIV-positive partner, 3 instances of unprotected receptive anal sex, 0 insertive anal acts with an HIV-positive partner, no poppers use, and no amphetamine use.","exampleUseCases":[{"title":"PrEP eligibility risk stratification","prompt":"I need to run the HIRI-MSM score for a 25-year-old patient who had 12 male sex partners in the past 6 months, 2 of whom were HIV-positive, he had unprotected receptive anal sex 5 times, insertive anal with an HIV-positive partner twice, he uses poppers but not amphetamines — tell me his total score and whether he's at or above 10."},{"title":"Research cohort risk classification","prompt":"For our study, score a 45-year-old participant using the Smith 2012 HIV incidence risk index: 4 male partners in the last 6 months, 0 HIV-positive partners, 0 unprotected receptive anal acts, 0 insertive anal acts with HIV-positive partners, no poppers, no amphetamines — what's his HIRI-MSM total?"},{"title":"Clinical decision support alert","prompt":"Run the seven-item HIRI-MSM on a 38-year-old man — 7 male sex partners last 6 months, 1 HIV-positive partner, 1 unprotected receptive anal encounter, 6 insertive anal acts with an HIV-positive partner, poppers user, no amphetamines — does he hit the high-risk threshold?"}],"resultDescription":"Returns the numeric HIRI-MSM total score (integer 0–47), a boolean or flag indicating whether the score is at or above 10 (the high-risk cutoff per Smith 2012), and optionally the per-item component scores contributing to the total. This is not a diagnosis and does not constitute a PrEP prescription or clinical recommendation.","failureModes":["Missing any of the seven required query parameters returns a validation error","Age below 18 or non-integer values rejected","Negative integers for partner counts or act counts are invalid","Boolean parameters passed as strings may fail parsing","Network or payment (x402) errors return non-200 status codes"],"whenToPreferThis":"Use this endpoint when you need a validated, published clinical risk score (Smith 2012 HIRI-MSM) for MSM HIV incidence risk stratification, especially in digital health, PrEP decision-support, or research pipelines. Prefer this over generic risk calculators when the specific seven-item Smith 2012 instrument is required and all behavioral inputs are available from a structured intake form or EHR.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:51:27.988Z","isFirstParty":false}