{"uid":"cap_AWKW-CnoQ_QJEykMC3eJw","slug":"magent-irae-colitis-grade-calculator-brahmer-2018-279e6a37","name":"magent irAE Colitis Grade Calculator (Brahmer 2018)","description":"Brahmer 2018 ASCO Table 2.1 irAE colitis grade from stools_over_baseline (0-40) and four caller-assigned flags. First-match: grade 4 if life_threatening; else 3 if stools >= 7 or incontinence or hospitalization_indicated or limiting_self_care; else 2 if stools >= 4; else 1. Returns icpi_action continue, hold, hold_consider_discontinue_ctla4, or permanently_discontinue. Ostomy-output bands not implemented. magent does not count stools. Not a medical device, not a diagnosis, not a steroid dose.","url":"https://api.magentlab.com/api/calc/irae_colitis","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":["stools_over_baseline","incontinence","hospitalization_indicated","limiting_self_care","life_threatening"],"properties":{"incontinence":{"type":"boolean","description":"Incontinence as assigned by the caller (Brahmer 2018 Table 2.1 grade 3). true or false. When true and life_threatening is false, grade is 3. magent does not examine the patient."},"life_threatening":{"type":"boolean","description":"Life-threatening consequences with urgent intervention indicated, as assigned by the caller (Brahmer 2018 Table 2.1 grade 4). true or false. When true, grade is 4 regardless of stool count. magent does not examine the patient."},"limiting_self_care":{"type":"boolean","description":"Limiting self-care ADL as assigned by the caller (Brahmer 2018 Table 2.1 grade 3). true or false. When true and life_threatening is false, grade is 3. magent does not assess ADL."},"stools_over_baseline":{"type":"integer","description":"Increase of stools per day over baseline as assigned by the caller (integer 0-40; Brahmer 2018 Table 2.1 CTCAE diarrhea). Fewer than four is grade 1; four to six is grade 2; seven or more is grade 3 unless life_threatening is true. Ostomy-output increase is not an input. magent does not count stools."},"hospitalization_indicated":{"type":"boolean","description":"Hospitalization indicated as assigned by the caller (Brahmer 2018 Table 2.1 grade 3). true or false. When true and life_threatening is false, grade is 3. magent does not admit 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_HYG7TOs9NKb0NNHlBTaoB","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":"Calculates immune-related adverse event (irAE) colitis grade (1–4) per Brahmer 2018 ASCO Table 2.1 and returns the corresponding ICI (immune checkpoint inhibitor) management action.","exampleAgentPrompt":"Grade the irAE colitis for a patient who has 5 stools over baseline, is not incontinent, has hospitalization indicated, is not limiting self-care, and is not life-threatening — and tell me what ICI action to take.","exampleUseCases":[{"title":"Automate ICI colitis grading in oncology workflow","prompt":"I have a patient on anti-PD-1 therapy with 8 stools over baseline, no incontinence, hospitalization is indicated, not limiting self-care, and not life-threatening — what irAE colitis grade are they and should immunotherapy be held or discontinued?"},{"title":"Life-threatening colitis flagged by clinician","prompt":"My patient has life-threatening colitis consequences requiring urgent intervention — regardless of stool count, what grade does that make the irAE colitis and what does Brahmer 2018 say to do with their checkpoint inhibitor?"},{"title":"Mild diarrhea on immunotherapy","prompt":"A patient on checkpoint inhibitor therapy has 3 stools over baseline, no incontinence, no hospitalization needed, not limiting self-care, and not life-threatening — what colitis grade is this and can they continue treatment?"}],"resultDescription":"Returns the irAE colitis grade (1–4) computed by first-match logic from the Brahmer 2018 ASCO Table 2.1 algorithm, plus the recommended ICI management action string: one of 'continue', 'hold', 'hold_consider_discontinue_ctla4', or 'permanently_discontinue'. Does not include steroid dosing, patient examination, or stool counting.","failureModes":["Missing required query parameters returns a validation error","stools_over_baseline outside integer range 0–40 may cause rejection or unexpected behavior","Ostomy-output increase is not supported as an input and will not be graded correctly","Conflicting flags (e.g., life_threatening=false but all grade-3 flags false and stools<4) defaults to grade 1","Payment failure (402) if USDC balance is insufficient for the $0.005 per-call fee"],"whenToPreferThis":"Choose this endpoint when you need a fast, rule-based irAE colitis grade and ICI action recommendation strictly following Brahmer 2018 ASCO Table 2.1 — particularly useful in agentic oncology workflows where caller-assigned clinical flags (incontinence, hospitalization, life-threatening) are already available and you need a structured, auditable grading output without LLM interpretation. Not appropriate when ostomy-output banding is required, steroid dosing is needed, or a licensed clinical judgment is sought.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:59.319Z","isFirstParty":false}