Health
Estimate the osmolality (mOsm/L) of a parenteral nutrition admixture to help choose peripheral vs central access. Sum-of-solute formula: Osm ≈ Dextrose(g/L)×5 + AA(g/L)×10 + Electrolytes. Thresholds: ≤ 900 peripheral; 900–1200 caution; > 1200 central. Lab-measured value is the gold standard. Derived from Mirtallo 2004, Pittiruti 2009, Dugan 2014. Not medical advice.
Call this tool from your code in three languages.
curl -X POST 'http://127.0.0.1:3003/en/api/tools/tpn-osmolality-estimator' \
-H 'Content-Type: application/json' \
-d '{"dextrosePercent":10,"dextroseVolume":1000,"aaPercent":5,"aaVolume":500,"lipidVolume":250,"electrolyteOsm":350,"decimalPlaces":0}'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST http://127.0.0.1:3003/en/api/tools/tpn-osmolality-estimator| Name | Type | Required | Description |
|---|---|---|---|
| dextrosePercent | number | Yes | Dextrose concentration % w/v. D25W = 25 g/100 mL. |
| dextroseVolume | number | Yes | Total dextrose volume (mL). |
| aaPercent | number | Yes | Amino-acid concentration % w/v. |
| aaVolume | number | Yes | Total amino-acid volume (mL). |
| lipidVolume | number | Yes |
Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-tpn-osmolality-estimator": {
"name": "tpn-osmolality-estimator",
"description": "Estimate the osmolality (mOsm/L) of a parenteral nutrition admixture to help choose peripheral vs central access. Sum-of-solute formula: Osm ≈ Dextrose(g/L)×5 + AA(g/L)×10 + Electrolytes. Thresholds: ≤ 900 peripheral; 900–1200 caution; > 1200 central. Lab-measured value is the gold standard. Derived from Mirtallo 2004, Pittiruti 2009, Dugan 2014. Not medical advice.",
"baseUrl": "http://127.0.0.1:3003/mcp/sse?toolId=tpn-osmolality-estimator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "tpn-osmolality-estimator",
"arguments": {
"dextrosePercent": 10,
"dextroseVolume": 1000,
"aaPercent": 5,
"aaVolume": 500,
"lipidVolume": 250,
"electrolyteOsm": 350,
"decimalPlaces": 0
}
}
}| Total lipid emulsion volume (mL). Lipid contributes ≈ 0 to osmolality and is subtracted from the aqueous denominator. |
| electrolyteOsm | number | Yes | Osmolality contribution of all added electrolytes (Na, K, Ca, Mg, P, acetate, etc.), read from the PN label or estimated. Typical maintenance ≈ 300–500 mOsm/L. |
| decimalPlaces | number | No | — |
JSON result
{
"key": {...},
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}Questions or issues? Contact [email protected]