{"uid":"cap_iE2dnUp_ekbBh4YwbQDL8","slug":"magent-pss-3-suicide-risk-screener-2d54989a","name":"magent PSS-3 Suicide Risk Screener","description":"Boudreaux 2015 PSS-3 from four caller-assigned flags: depressed_mood (2-week segue, not in the screen), ideation_2_weeks, lifetime_attempt, and attempt_within_6_months. screen_positive if 2-week ideation or a lifetime attempt within 6 months (ED-SAFE / Boudreaux 2016 Am J Prev Med). Depression is not factored into screening results. magent does not interview the patient. Not a diagnosis. Not C-SSRS. Not a medical device.","url":"https://api.magentlab.com/api/calc/pss_3","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":["depressed_mood","ideation_2_weeks","lifetime_attempt","attempt_within_6_months"],"properties":{"depressed_mood":{"type":"boolean","description":"Over the past 2 weeks, felt down, depressed, or hopeless (Boudreaux 2015 PSS-3 segue item). true or false as assigned by the caller. Not factored into screen_positive. magent does not interview the patient."},"ideation_2_weeks":{"type":"boolean","description":"Active suicidal ideation in the past 2 weeks (Boudreaux 2015: over the past 2 weeks, thoughts of killing yourself). true or false as assigned by the caller. screen_positive is true if this is true. magent does not interview the patient."},"lifetime_attempt":{"type":"boolean","description":"Lifetime suicide attempt (Boudreaux 2015: ever attempted to kill yourself). true or false as assigned by the caller. If false, attempt_within_6_months must be false. magent does not interview the patient."},"attempt_within_6_months":{"type":"boolean","description":"Most recent suicide attempt was within 6 months (Boudreaux 2015 timing follow-up). true or false as assigned by the caller. Always required. If lifetime_attempt is false this must be false. screen_positive is true when lifetime_attempt and this are both true. magent does not interview the patient."}}}},"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_IQoq-ifmTCUFex2PPGF0B","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 Boudreaux 2015 PSS-3 suicide risk screen result (positive/negative) from four caller-assigned clinical flags, following the ED-SAFE protocol","exampleAgentPrompt":"Run the PSS-3 suicide screen on this patient: they reported depressed mood over the past 2 weeks (true), they have active suicidal ideation in the past 2 weeks (true), they have no lifetime suicide attempt (false), and attempt within 6 months is false — tell me if they screen positive.","exampleUseCases":[{"title":"ED triage suicide screening","prompt":"I need to run the PSS-3 suicide risk screen on a patient in the ED: depressed mood is true, they reported suicidal ideation in the past 2 weeks (true), they've never attempted suicide (lifetime_attempt false), and attempt within 6 months is false — does this patient screen positive?"},{"title":"No ideation, prior recent attempt","prompt":"Screen this patient using PSS-3: no depressed mood (false), no ideation in the past 2 weeks (false), they have a lifetime suicide attempt (true), and the attempt was within the past 6 months (true) — what does the screen return?"},{"title":"Behavioral health intake risk flag","prompt":"Using the Boudreaux PSS-3 protocol, evaluate a behavioral health intake patient: depressed mood true, no suicidal ideation in the past 2 weeks (false), no lifetime attempt (false), attempt within 6 months false — do they screen positive or negative?"}],"resultDescription":"Returns a structured JSON object indicating whether the patient screens positive for suicide risk (screen_positive boolean) based on the ED-SAFE / Boudreaux 2015 PSS-3 algorithm: positive if ideation_2_weeks is true OR if both lifetime_attempt and attempt_within_6_months are true. Depression flag is not factored into screen_positive. Not a diagnosis, not C-SSRS, not a medical device.","failureModes":["Missing required query parameters (depressed_mood, ideation_2_weeks, lifetime_attempt, attempt_within_6_months) returns a 400 or validation error","attempt_within_6_months set to true when lifetime_attempt is false — logically invalid combination per protocol","Non-boolean values passed for flag parameters cause schema validation failure","Network or upstream API errors return 5xx responses","Payment/x402 authorization failure if USDC payment not provided"],"whenToPreferThis":"Use this endpoint when you need a fast, protocol-compliant PSS-3 (ED-SAFE / Boudreaux 2015/2016) suicide risk screen computation from four discrete caller-assigned flags — it is not C-SSRS, not a full clinical interview, and not a diagnosis. Prefer this over general-purpose LLM reasoning when you need an auditable, rule-based algorithm that faithfully implements the published PSS-3 screening logic without hallucination risk.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:57:27.251Z","isFirstParty":false}