Emergency · LIVE
SLEDAI-2K disease activity index
SLEDAI-2K
Sum Gladman 2002 SLEDAI-2K weights from 24 caller-assigned descriptors present in the last 10 days and return the integer score (max 105). Not a diagnosis.
Markdown: /docs/sledai-2k.md · Canonical: https://magentlab.com/docs/sledai-2k
Not a medical device. Not a diagnosis, dose, or listing recommendation.
What it computes
Sum Gladman 2002 SLEDAI-2K weights from 24 caller-assigned descriptors present in the last 10 days and return the integer score (max 105). Not a diagnosis.
When to use
When an agent already has the 24 Gladman 2002 SLEDAI-2K descriptors assigned for the last 10 days and needs that paper's weighted total. magent does not examine the patient, diagnose SLE, score SLICC damage, or apply SELENA-SLEDAI flare rules.
When not to use
- Not a medical device and not a diagnosis of systemic lupus erythematosus or a treatment order.
- Each of the 24 descriptors is caller-assigned for the last 10 days. magent does not examine the patient, assay urine or serology, or read imaging.
- SLEDAI-2K vs original SLEDAI: proteinuria scores if >0.5 g/24 h (not the original >3.5 g/24 h only). Rash, alopecia, and mucosal ulcers score if new or persistent (not new only).
- Does not implement SLICC/ACR damage. Does not implement SELENA-SLEDAI flare rules. Does not invent mild, moderate, or severe bands.
- This is the Gladman 2002 SLEDAI-2K weighted integer only (max 105). Not a classification of SLE.
Formula
SLEDAI-2K = 8*(seizure + psychosis + organic_brain_syndrome + visual_disturbance + cranial_nerve_disorder + lupus_headache + cva + vasculitis) + 4*(arthritis + myositis + urinary_casts + hematuria + proteinuria + pyuria) + 2*(rash + alopecia + mucosal_ulcers + pleurisy + pericarditis + low_complement + increased_dna_binding) + (fever + thrombocytopenia + leukopenia); Gladman 2002; each descriptor present in the last 10 days as assigned by the caller; proteinuria scores if >0.5 g/24 h (not original SLEDAI >3.5 g/24 h only); rash, alopecia, and mucosal ulcers score if new or persistent (not new only); max 105; not a diagnosis
Citation
- Authors
- Gladman DD, Ibañez D, Urowitz MB
- Source
- J Rheumatol. 2002;29(2):288-291
- DOI
- none
Worked example
Arthritis and rash only
Given:
alopecia=falsearthritis=truecranial_nerve_disorder=falsecva=falsefever=falsehematuria=falseincreased_dna_binding=falseleukopenia=falselow_complement=falselupus_headache=falsemucosal_ulcers=falsemyositis=falseorganic_brain_syndrome=falsepericarditis=falsepleurisy=falseproteinuria=falsepsychosis=falsepyuria=falserash=trueseizure=falsethrombocytopenia=falseurinary_casts=falsevasculitis=falsevisual_disturbance=false
- arthritis true scores 4; rash true scores 2 (new or persistent under SLEDAI-2K)
- remaining 22 descriptors false
- score = 6 (max 105). Not a diagnosis.
No descriptors present
Given:
alopecia=falsearthritis=falsecranial_nerve_disorder=falsecva=falsefever=falsehematuria=falseincreased_dna_binding=falseleukopenia=falselow_complement=falselupus_headache=falsemucosal_ulcers=falsemyositis=falseorganic_brain_syndrome=falsepericarditis=falsepleurisy=falseproteinuria=falsepsychosis=falsepyuria=falserash=falseseizure=falsethrombocytopenia=falseurinary_casts=falsevasculitis=falsevisual_disturbance=false
- all 24 Gladman 2002 descriptors are false as assigned by the caller
- score = 0 (max 105)
All 24 descriptors present
Given:
alopecia=truearthritis=truecranial_nerve_disorder=truecva=truefever=truehematuria=trueincreased_dna_binding=trueleukopenia=truelow_complement=truelupus_headache=truemucosal_ulcers=truemyositis=trueorganic_brain_syndrome=truepericarditis=truepleurisy=trueproteinuria=truepsychosis=truepyuria=truerash=trueseizure=truethrombocytopenia=trueurinary_casts=truevasculitis=truevisual_disturbance=true
- all 24 Gladman 2002 descriptors are true as assigned by the caller
- 8×8 + 6×4 + 7×2 + 3×1 = 105 (max 105). Not a diagnosis.
Also searched as
- SLEDAI-2K
- SLEDAI 2000
- systemic lupus erythematosus disease activity index 2000
- Gladman SLEDAI
- SLEDAI-2K score
- lupus disease activity index
- SLEDAI 2K
- Gladman 2002 SLEDAI-2K
Try
Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.
Full URL: https://api.magentlab.com/api/calc/sledai_2k?seizure=false&psychosis=false&organic_brain_syndrome=false&visual_disturbance=false&cranial_nerve_disorder=false&lupus_headache=false&cva=false&vasculitis=false&arthritis=true&myositis=false&urinary_casts=false&hematuria=false&proteinuria=false&pyuria=false&rash=true&alopecia=false&mucosal_ulcers=false&pleurisy=false&pericarditis=false&low_complement=false&increased_dna_binding=false&fever=false&thrombocytopenia=false&leukopenia=false
Call
Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params
return HTTP 400 before any quote or charge.
curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/sledai_2k?seizure=false&psychosis=false&organic_brain_syndrome=false&visual_disturbance=false&cranial_nerve_disorder=false&lupus_headache=false&cva=false&vasculitis=false&arthritis=true&myositis=false&urinary_casts=false&hematuria=false&proteinuria=false&pyuria=false&rash=true&alopecia=false&mucosal_ulcers=false&pleurisy=false&pericarditis=false&low_complement=false&increased_dna_binding=false&fever=false&thrombocytopenia=false&leukopenia=false"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seizure |
boolean | required | Seizure in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K). Recent onset. Exclude metabolic, infectious, or drug cause. true scores 8. magent does not examine the patient. |
psychosis |
boolean | required | Psychosis in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): altered ability to function in normal activity due to severe disturbance in the perception of reality. Exclude uremia and drug causes. true scores 8. magent does not examine the patient. |
organic_brain_syndrome |
boolean | required | Organic brain syndrome in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): altered mental function with impaired orientation, memory, or other intellectual function, rapid onset and fluctuating features. Exclude metabolic, infectious, or drug causes. true scores 8. magent does not examine the patient. |
visual_disturbance |
boolean | required | Visual disturbance in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): retinal changes of SLE (cytoid bodies, retinal hemorrhages, serous exudate or hemorrhages in the choroid, or optic neuritis). Exclude hypertension, infection, or drug causes. true scores 8. magent does not examine the fundus. |
cranial_nerve_disorder |
boolean | required | Cranial nerve disorder in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): new onset of sensory or motor neuropathy involving cranial nerves. true scores 8. magent does not examine cranial nerves. |
lupus_headache |
boolean | required | Lupus headache in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): severe persistent headache; may be migrainous, but must be nonresponsive to narcotic analgesia. true scores 8. magent does not examine the patient. |
cva |
boolean | required | Cerebrovascular accident in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): new onset of CVA(s). Exclude arteriosclerosis. true scores 8. magent does not read imaging. |
vasculitis |
boolean | required | Vasculitis in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): ulceration, gangrene, tender finger nodules, periungual infarction, splinter hemorrhages, or biopsy or angiogram proof of vasculitis. true scores 8. magent does not examine skin or read a biopsy. |
arthritis |
boolean | required | Arthritis in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): more than 2 joints with pain and signs of inflammation (tenderness, swelling, or effusion). true scores 4. magent does not examine joints. |
myositis |
boolean | required | Myositis in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): proximal muscle aching/weakness with elevated creatine phosphokinase/aldolase, EMG changes, or a biopsy showing myositis. true scores 4. magent does not assay muscle enzymes. |
urinary_casts |
boolean | required | Urinary casts in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): heme-granular or red blood cell casts. true scores 4. magent does not assay urine. |
hematuria |
boolean | required | Hematuria in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): >5 red blood cells/high power field. Exclude stone, infection, or other cause. true scores 4. magent does not assay urine. |
proteinuria |
boolean | required | Proteinuria in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): >0.5 g/24 h (not original SLEDAI >3.5 g/24 h only). true scores 4. magent does not assay urine. |
pyuria |
boolean | required | Pyuria in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): >5 white blood cells/high power field. Exclude infection. true scores 4. magent does not assay urine. |
rash |
boolean | required | Rash in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): inflammatory type rash. Scores if new or persistent (not original SLEDAI new only). true scores 2. magent does not examine skin. |
alopecia |
boolean | required | Alopecia in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): abnormal, patchy or diffuse loss of hair. Scores if new or persistent (not original SLEDAI new only). true scores 2. magent does not examine the scalp. |
mucosal_ulcers |
boolean | required | Mucosal ulcers in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): oral or nasal ulcerations. Scores if new or persistent (not original SLEDAI new only). true scores 2. magent does not examine mucosa. |
pleurisy |
boolean | required | Pleurisy in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): pleuritic chest pain with pleural rub or effusion, or pleural thickening. true scores 2. magent does not examine the chest. |
pericarditis |
boolean | required | Pericarditis in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): pericardial pain with at least one of rub, effusion, or electrocardiogram or echocardiogram confirmation. true scores 2. magent does not examine the heart. |
low_complement |
boolean | required | Low complement in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): CH50, C3, or C4 below the lower limit of normal for the testing laboratory. true scores 2. magent does not assay complement. |
increased_dna_binding |
boolean | required | Increased DNA binding in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): DNA binding by Farr assay above the normal range for the testing laboratory. true scores 2. magent does not assay anti-dsDNA. |
fever |
boolean | required | Fever in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): >38°C. Exclude infectious cause. true scores 1. magent does not measure temperature. |
thrombocytopenia |
boolean | required | Thrombocytopenia in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): <100,000 platelets/mm³. Exclude drug causes. true scores 1. magent does not assay platelets. |
leukopenia |
boolean | required | Leukopenia in the last 10 days as assigned by the caller (Gladman 2002 SLEDAI-2K): <3,000 white blood cells/mm³. Exclude drug causes. true scores 1. magent does not assay blood counts. |
Bulk (POST)
POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.
- 1 to 25 items. Each item uses the same keys as the GET query parameters.
- POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
- The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
- HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
- Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
- x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.
Example request (fixture)
{
"items": [
{
"alopecia": "false",
"arthritis": "true",
"cranial_nerve_disorder": "false",
"cva": "false",
"fever": "false",
"hematuria": "false",
"increased_dna_binding": "false",
"leukopenia": "false",
"low_complement": "false",
"lupus_headache": "false",
"mucosal_ulcers": "false",
"myositis": "false",
"organic_brain_syndrome": "false",
"pericarditis": "false",
"pleurisy": "false",
"proteinuria": "false",
"psychosis": "false",
"pyuria": "false",
"rash": "true",
"seizure": "false",
"thrombocytopenia": "false",
"urinary_casts": "false",
"vasculitis": "false",
"visual_disturbance": "false"
},
{
"alopecia": "false",
"arthritis": "true",
"cranial_nerve_disorder": "false",
"cva": "false",
"fever": "false",
"hematuria": "false",
"increased_dna_binding": "false",
"leukopenia": "false",
"low_complement": "false",
"lupus_headache": "false",
"mucosal_ulcers": "false",
"myositis": "false",
"organic_brain_syndrome": "false",
"pericarditis": "false",
"pleurisy": "false",
"proteinuria": "false",
"psychosis": "false",
"pyuria": "false",
"rash": "true",
"seizure": "false",
"thrombocytopenia": "false",
"urinary_casts": "false",
"vasculitis": "false",
"visual_disturbance": "false"
}
]
}
Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.
Example 200 (fixture)
{
"count": 2,
"path": "/api/calc/sledai_2k",
"items": [
{
"components": [
{
"factor": "seizure",
"points": 0,
"present": false
},
{
"factor": "psychosis",
"points": 0,
"present": false
},
{
"factor": "organic_brain_syndrome",
"points": 0,
"present": false
},
{
"factor": "visual_disturbance",
"points": 0,
"present": false
},
{
"factor": "cranial_nerve_disorder",
"points": 0,
"present": false
},
{
"factor": "lupus_headache",
"points": 0,
"present": false
},
{
"factor": "cva",
"points": 0,
"present": false
},
{
"factor": "vasculitis",
"points": 0,
"present": false
},
{
"factor": "arthritis",
"points": 4,
"present": true
},
{
"factor": "myositis",
"points": 0,
"present": false
},
{
"factor": "urinary_casts",
"points": 0,
"present": false
},
{
"factor": "hematuria",
"points": 0,
"present": false
},
{
"factor": "proteinuria",
"points": 0,
"present": false
},
{
"factor": "pyuria",
"points": 0,
"present": false
},
{
"factor": "rash",
"points": 2,
"present": true
},
{
"factor": "alopecia",
"points": 0,
"present": false
},
{
"factor": "mucosal_ulcers",
"points": 0,
"present": false
},
{
"factor": "pleurisy",
"points": 0,
"present": false
},
{
"factor": "pericarditis",
"points": 0,
"present": false
},
{
"factor": "low_complement",
"points": 0,
"present": false
},
{
"factor": "increased_dna_binding",
"points": 0,
"present": false
},
{
"factor": "fever",
"points": 0,
"present": false
},
{
"factor": "thrombocytopenia",
"points": 0,
"present": false
},
{
"factor": "leukopenia",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Gladman DD, Ibañez D, Urowitz MB",
"id": "gladman-2002",
"pmid": "11838846",
"source": "J Rheumatol. 2002;29(2):288-291",
"title": "Systemic lupus erythematosus disease activity index 2000"
},
"formula": "sledai_2k",
"formula_expression": "SLEDAI-2K = 8*(seizure + psychosis + organic_brain_syndrome + visual_disturbance + cranial_nerve_disorder + lupus_headache + cva + vasculitis) + 4*(arthritis + myositis + urinary_casts + hematuria + proteinuria + pyuria) + 2*(rash + alopecia + mucosal_ulcers + pleurisy + pericarditis + low_complement + increased_dna_binding) + (fever + thrombocytopenia + leukopenia); Gladman 2002; each descriptor present in the last 10 days as assigned by the caller; proteinuria scores if >0.5 g/24 h (not original SLEDAI >3.5 g/24 h only); rash, alopecia, and mucosal ulcers score if new or persistent (not new only); max 105; not a diagnosis",
"max_score": 105,
"score": 6
},
{
"components": [
{
"factor": "seizure",
"points": 0,
"present": false
},
{
"factor": "psychosis",
"points": 0,
"present": false
},
{
"factor": "organic_brain_syndrome",
"points": 0,
"present": false
},
{
"factor": "visual_disturbance",
"points": 0,
"present": false
},
{
"factor": "cranial_nerve_disorder",
"points": 0,
"present": false
},
{
"factor": "lupus_headache",
"points": 0,
"present": false
},
{
"factor": "cva",
"points": 0,
"present": false
},
{
"factor": "vasculitis",
"points": 0,
"present": false
},
{
"factor": "arthritis",
"points": 4,
"present": true
},
{
"factor": "myositis",
"points": 0,
"present": false
},
{
"factor": "urinary_casts",
"points": 0,
"present": false
},
{
"factor": "hematuria",
"points": 0,
"present": false
},
{
"factor": "proteinuria",
"points": 0,
"present": false
},
{
"factor": "pyuria",
"points": 0,
"present": false
},
{
"factor": "rash",
"points": 2,
"present": true
},
{
"factor": "alopecia",
"points": 0,
"present": false
},
{
"factor": "mucosal_ulcers",
"points": 0,
"present": false
},
{
"factor": "pleurisy",
"points": 0,
"present": false
},
{
"factor": "pericarditis",
"points": 0,
"present": false
},
{
"factor": "low_complement",
"points": 0,
"present": false
},
{
"factor": "increased_dna_binding",
"points": 0,
"present": false
},
{
"factor": "fever",
"points": 0,
"present": false
},
{
"factor": "thrombocytopenia",
"points": 0,
"present": false
},
{
"factor": "leukopenia",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Gladman DD, Ibañez D, Urowitz MB",
"id": "gladman-2002",
"pmid": "11838846",
"source": "J Rheumatol. 2002;29(2):288-291",
"title": "Systemic lupus erythematosus disease activity index 2000"
},
"formula": "sledai_2k",
"formula_expression": "SLEDAI-2K = 8*(seizure + psychosis + organic_brain_syndrome + visual_disturbance + cranial_nerve_disorder + lupus_headache + cva + vasculitis) + 4*(arthritis + myositis + urinary_casts + hematuria + proteinuria + pyuria) + 2*(rash + alopecia + mucosal_ulcers + pleurisy + pericarditis + low_complement + increased_dna_binding) + (fever + thrombocytopenia + leukopenia); Gladman 2002; each descriptor present in the last 10 days as assigned by the caller; proteinuria scores if >0.5 g/24 h (not original SLEDAI >3.5 g/24 h only); rash, alopecia, and mucosal ulcers score if new or persistent (not new only); max 105; not a diagnosis",
"max_score": 105,
"score": 6
}
]
}
Response
| Field | Type | Description |
|---|---|---|
formula |
string | sledai_2k |
formula_expression |
string | Exact expression used |
score |
integer | SLEDAI-2K weighted sum 0-105 (Gladman 2002). Not a diagnosis. |
max_score |
integer | 105 |
components |
array | Per-descriptor points |
citation |
object | Gladman et al. J Rheumatol 2002 citation |
disclaimer |
string | Not-a-device notice |
Example JSON
Machine form of the same example. Frozen fixture. Not a live lookup.
{
"components": [
{
"factor": "seizure",
"points": 0,
"present": false
},
{
"factor": "psychosis",
"points": 0,
"present": false
},
{
"factor": "organic_brain_syndrome",
"points": 0,
"present": false
},
{
"factor": "visual_disturbance",
"points": 0,
"present": false
},
{
"factor": "cranial_nerve_disorder",
"points": 0,
"present": false
},
{
"factor": "lupus_headache",
"points": 0,
"present": false
},
{
"factor": "cva",
"points": 0,
"present": false
},
{
"factor": "vasculitis",
"points": 0,
"present": false
},
{
"factor": "arthritis",
"points": 4,
"present": true
},
{
"factor": "myositis",
"points": 0,
"present": false
},
{
"factor": "urinary_casts",
"points": 0,
"present": false
},
{
"factor": "hematuria",
"points": 0,
"present": false
},
{
"factor": "proteinuria",
"points": 0,
"present": false
},
{
"factor": "pyuria",
"points": 0,
"present": false
},
{
"factor": "rash",
"points": 2,
"present": true
},
{
"factor": "alopecia",
"points": 0,
"present": false
},
{
"factor": "mucosal_ulcers",
"points": 0,
"present": false
},
{
"factor": "pleurisy",
"points": 0,
"present": false
},
{
"factor": "pericarditis",
"points": 0,
"present": false
},
{
"factor": "low_complement",
"points": 0,
"present": false
},
{
"factor": "increased_dna_binding",
"points": 0,
"present": false
},
{
"factor": "fever",
"points": 0,
"present": false
},
{
"factor": "thrombocytopenia",
"points": 0,
"present": false
},
{
"factor": "leukopenia",
"points": 0,
"present": false
}
],
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Gladman DD, Ibañez D, Urowitz MB",
"id": "gladman-2002",
"pmid": "11838846",
"source": "J Rheumatol. 2002;29(2):288-291",
"title": "Systemic lupus erythematosus disease activity index 2000"
},
"formula": "sledai_2k",
"formula_expression": "SLEDAI-2K = 8*(seizure + psychosis + organic_brain_syndrome + visual_disturbance + cranial_nerve_disorder + lupus_headache + cva + vasculitis) + 4*(arthritis + myositis + urinary_casts + hematuria + proteinuria + pyuria) + 2*(rash + alopecia + mucosal_ulcers + pleurisy + pericarditis + low_complement + increased_dna_binding) + (fever + thrombocytopenia + leukopenia); Gladman 2002; each descriptor present in the last 10 days as assigned by the caller; proteinuria scores if >0.5 g/24 h (not original SLEDAI >3.5 g/24 h only); rash, alopecia, and mucosal ulcers score if new or persistent (not new only); max 105; not a diagnosis",
"max_score": 105,
"score": 6
}
Client errors (HTTP 400)
Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_sledai |
SLEDAI-2K needs the twenty-four Gladman 2002 descriptors as true or false (last 10 days). Returned before settlement; you are not charged. |
| 400 | invalid_items |
POST body must be a JSON object with only an items array Returned before settlement; you are not charged. |
| 400 | invalid_item_count |
items must be an array of 1 to 25 objects Returned before settlement; you are not charged. |
| 400 | invalid_item |
each items entry must be a JSON object Returned before settlement; you are not charged. |
Related tools
- SLICC SLE — Apply the 2012 SLICC classification criteria for systemic lupus erythematosus (Petri Table 3): return clinical_count, immunologic_count, the biopsy-nephritis shortcut, and whether the published rule classifies SLE. Not a diagnosis.
- DAS28-CRP — Compute the Wells 2009 28-joint Disease Activity Score based on C-reactive protein from caller-assigned TJC28, SJC28, CRP in mg/L, and 0–100 mm general health, including the +0.96 constant, and return DAS28-defined remission when the score is <2.6.
Payment
Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64
PAYMENT-REQUIRED
header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake
and shared payment errors: Payments.
Stdio MCP: /docs/mcp.
Guarantees
- HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
- exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
- HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
- Execution is timeout-bounded and concurrency-capped.
- Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.