{"uid":"cap_dp1d0x2sdoJ79EetPHegX","slug":"magent-mtoq-4-migraine-treatment-optimization-questionnaire-calculator-c1f75e12","name":"magent mTOQ-4 Migraine Treatment Optimization Questionnaire Calculator","description":"Lipton 2015 mTOQ-4 from four caller-assigned frequency items: pain-free within 2 hours, one dose keeps headache away ≥24 hours, comfortable enough to plan daily activities, in control enough to return to normal function. Each never=0, rarely=0, less_than_half=1, half_or_greater=2. Sum 0-8. Bands very_poor 0, poor 1-5, moderate 6-7, maximum 8. magent does not interview the patient. Not a diagnosis, not an abortive-drug order, not the 19-item or 6-item mTOQ.","url":"https://api.magentlab.com/api/calc/mtoq_4","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":["pain_free_2h","sustained_24h","able_to_plan","in_control"],"properties":{"in_control":{"enum":["never","rarely","less_than_half","half_or_greater"],"type":"string","description":"Caller-assigned Lipton 2015 mTOQ-4 item 4. After taking your migraine medication, do you feel in control of your migraines enough so that you feel you can return to normal function? never=0, rarely=0, less_than_half=1, half_or_greater=2. magent does not interview the patient."},"able_to_plan":{"enum":["never","rarely","less_than_half","half_or_greater"],"type":"string","description":"Caller-assigned Lipton 2015 mTOQ-4 item 3. Are you comfortable enough with your migraine medication to be able to plan your daily activities? never=0, rarely=0, less_than_half=1, half_or_greater=2. magent does not interview the patient."},"pain_free_2h":{"enum":["never","rarely","less_than_half","half_or_greater"],"type":"string","description":"Caller-assigned Lipton 2015 mTOQ-4 item 1. After taking your migraine medication, are you pain-free within 2 hours for most attacks? never=0, rarely=0, less_than_half=1, half_or_greater=2. magent does not interview the patient."},"sustained_24h":{"enum":["never","rarely","less_than_half","half_or_greater"],"type":"string","description":"Caller-assigned Lipton 2015 mTOQ-4 item 2. Does one dose of your migraine medication usually relieve your headache and keep it away for at least 24 hours? never=0, rarely=0, less_than_half=1, half_or_greater=2. 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_lhzmZOm0D98NdR0n0UONO","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 the Lipton 2015 mTOQ-4 score (0–8) from four caller-assigned migraine treatment response frequency items and returns a categorical treatment quality band","exampleAgentPrompt":"Calculate the mTOQ-4 migraine treatment score for a patient whose responses are: pain-free within 2 hours = half_or_greater, one dose keeps headache away 24 hours = less_than_half, comfortable enough to plan daily activities = rarely, in control enough to return to normal function = half_or_greater.","exampleUseCases":[{"title":"Post-visit migraine treatment review","prompt":"I've collected a patient's mTOQ-4 responses after three months on their new triptan: they're pain-free within 2 hours half_or_greater of the time, one dose sustains relief for 24 hours less_than_half of the time, they can plan daily activities rarely, and they feel in control half_or_greater of the time — what's their mTOQ-4 score and band?"},{"title":"Comparing treatment regimens at population level","prompt":"For our migraine clinic audit, compute the mTOQ-4 for a patient whose responses are pain_free_2h=never, sustained_24h=rarely, able_to_plan=half_or_greater, in_control=less_than_half — I need the numeric score and the quality band."},{"title":"Flagging very poor migraine medication responders","prompt":"Can you run the four-item mTOQ-4 for a patient who answered never to being pain-free in 2 hours, never to sustained 24-hour relief, never to being able to plan activities, and never to feeling in control — I want to confirm they land in the very_poor band before escalating their care."}],"resultDescription":"Returns the computed mTOQ-4 total score (integer 0–8) and a categorical band label: very_poor (0), poor (1–5), moderate (6–7), or maximum (8), derived from summing the four frequency items where never/rarely=0, less_than_half=1, half_or_greater=2.","failureModes":["Missing any of the four required query parameters returns a validation error","Invalid enum values (e.g. 'sometimes' instead of 'less_than_half') cause a 400 bad request","Network or payment authorization failure returns a 402 or connection error","Passing non-GET HTTP method to this endpoint returns an error"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic computation of the validated Lipton 2015 mTOQ-4 four-item score from pre-collected patient frequency responses. Prefer this over manual summation to avoid arithmetic errors and ensure correct band classification. This is specifically the 4-item version — not the 19-item or 6-item mTOQ variants. The caller must already have the four frequency responses; this endpoint does not conduct patient interviews or support diagnostic or prescribing workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:00:42.370Z","isFirstParty":false}