{"uid":"cap_CjLmwZdLVQtCi6PJL8qqA","slug":"mapi-modified-asthma-predictive-index-calculator-c5899a30","name":"mAPI (Modified Asthma Predictive Index) Calculator","description":"Guilbert 2004 mAPI (PEAK Table I). Positive if 4+ wheeze episodes in one year (one MD-diagnosed) plus 1+ major or 2+ minor. Majors: parental asthma, MD atopic dermatitis, aeroallergen sensitization. Minors: milk/egg/peanut sensitization, wheezing unrelated to colds, eosinophils ≥4%. Not original API. Not m²API. Not an asthma diagnosis. magent does not examine the child. Not a medical device.","url":"https://api.magentlab.com/api/calc/mapi","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":["four_or_more_wheeze_episodes","parental_asthma","md_atopic_dermatitis","aeroallergen_sensitization","food_sensitization_milk_egg_peanut","wheezing_unrelated_to_colds","eosinophilia_ge_4pct"],"properties":{"parental_asthma":{"type":"boolean","description":"Parental asthma as assigned by the caller. true or false. Major criterion (Guilbert 2004 PEAK Table I). magent does not take a family history."},"eosinophilia_ge_4pct":{"type":"boolean","description":"Blood eosinophils ≥4% of WBC as assigned by the caller (Guilbert 2004 PEAK Table I; 4% or greater). true or false. Minor criterion. magent does not take an eosinophil percent and does not interpret a CBC. Not Castro-Rodriguez circulating eosinophils >4%."},"md_atopic_dermatitis":{"type":"boolean","description":"Physician-diagnosed atopic dermatitis as assigned by the caller. true or false. Major criterion (Guilbert 2004 PEAK Table I). magent does not examine the child."},"aeroallergen_sensitization":{"type":"boolean","description":"Allergic sensitization to at least one aeroallergen as assigned by the caller. true or false. Major criterion (Guilbert 2004 PEAK Table I). magent does not interpret allergy testing."},"wheezing_unrelated_to_colds":{"type":"boolean","description":"Wheezing unrelated to colds as assigned by the caller. true or false. Minor criterion (Guilbert 2004 PEAK Table I). magent does not auscultate."},"four_or_more_wheeze_episodes":{"type":"boolean","description":"Caller-assigned history of 4 or more wheezing episodes in one year with at least one physician-diagnosed episode (Guilbert 2004 PEAK Table I primary criterion). true or false. magent does not take a numeric episode count."},"food_sensitization_milk_egg_peanut":{"type":"boolean","description":"Allergic sensitization to milk, egg, or peanuts as assigned by the caller. true or false. Minor criterion (Guilbert 2004 PEAK Table I). magent does not interpret allergy testing."}}}},"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_fKhFwnOmdIPn-Uxp69vi5","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 Guilbert 2004 PEAK Trial modified Asthma Predictive Index (mAPI) result for a young child based on caller-supplied boolean criteria for wheeze frequency, major risk factors, and minor risk factors.","exampleAgentPrompt":"Calculate the mAPI for a child who has had 4 or more wheeze episodes this year (at least one doctor-diagnosed), whose parent has asthma, who has been diagnosed with atopic dermatitis by a physician, has no aeroallergen sensitization, no food sensitization to milk/egg/peanut, does wheeze unrelated to colds, and whose eosinophils are below 4%.","exampleUseCases":[{"title":"Asthma risk flag in clinical summary tool","prompt":"I have a toddler patient with 4+ wheeze episodes this year (one MD-diagnosed), parental asthma, and no atopic dermatitis or aeroallergen sensitization, but eosinophils are at 5% and they do wheeze outside of colds — can you run the mAPI on those criteria?"},{"title":"Research cohort eligibility screening","prompt":"For our PEAK-aligned study, I need to screen a child: 4+ wheeze episodes per year with one MD-confirmed, no parental asthma, no physician-diagnosed eczema, no aeroallergen sensitization, positive for milk/egg/peanut sensitization, no cold-unrelated wheezing, and eosinophils under 4% — what does the mAPI come back as?"},{"title":"Educational illustration of mAPI logic","prompt":"Walk me through the mAPI result for a hypothetical child with 4+ wheeze episodes (one MD-diagnosed), parental asthma as the only major criterion, and wheezing unrelated to colds plus eosinophilia ≥4% as the two minor criteria — is that a positive index?"}],"resultDescription":"Returns whether the mAPI is positive or negative based on the Guilbert 2004 PEAK Table I algorithm: positive requires 4+ wheeze episodes in one year (≥1 MD-diagnosed) plus either 1 major criterion (parental asthma, physician-diagnosed atopic dermatitis, or aeroallergen sensitization) or 2 minor criteria (food sensitization to milk/egg/peanut, wheezing unrelated to colds, or eosinophilia ≥4%). Response includes the classification and the contributing criterion flags.","failureModes":["Missing required boolean query parameters returns a validation error","Passing non-boolean values to boolean fields causes schema rejection","four_or_more_wheeze_episodes=false always yields mAPI negative regardless of other criteria","Payment failure (x402) if USDC balance insufficient or payment header missing","Network timeout if the magentlab API is unavailable"],"whenToPreferThis":"Use this endpoint when you need a programmatic, structured application of the Guilbert 2004 PEAK Trial mAPI algorithm and all seven boolean criteria have already been clinically assessed and assigned by a qualified caller. Prefer this over manual scoring when building clinical summary tools, research screening pipelines, or educational demonstrations that require reliable, reproducible mAPI computations. Do not use as a standalone diagnostic tool or substitute for physician evaluation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:58:53.176Z","isFirstParty":false}