Health
Vital Capacity Estimator (Height / Age / Sex)
Estimate expected adult vital capacity with the Baldwin equations ((27.63 − 0.112×age)×height for males, (21.78 − 0.101×age)×height for females) and optionally grade a measured VC as % predicted. Not medical advice.
json· JSON resultOpen tool
Quick start
Call this tool from your code in three languages.
cURL
curl -X POST 'https://api.elysiatools.com/en/api/tools/vital-capacity-estimator' \
-H 'Content-Type: application/json' \
-d '{"sex":"male","heightCm":180,"ageYears":25,"measuredVc":0,"measuredUnit":"L","decimalPlaces":1}'API reference
Send a POST request with your inputs as JSON. File parameters require a separate upload first.
Endpoint
HTTP
POST https://api.elysiatools.com/en/api/tools/vital-capacity-estimatorParameters
| Name | Type | Required | Description |
|---|---|---|---|
| sex | select | Yes | Sex for the Baldwin prediction equation. |
| heightCm | number | Yes | Height in centimeters (100–250). |
| ageYears | number | Yes | Age in years (15–100). |
| measuredVc | number | No | Optional measured vital capacity in the selected unit (0.5–9 L or 500–9000 mL); enables % predicted and severity grading. |
| measuredUnit | select | No |
MCP integration
Add this tool to your Model Context Protocol server so AI agents can list and call it.
Server configuration
Add this block to your MCP client configuration:
mcp.json
{
"mcpServers": {
"elysiatools-vital-capacity-estimator": {
"name": "vital-capacity-estimator",
"description": "Estimate expected adult vital capacity with the Baldwin equations ((27.63 − 0.112×age)×height for males, (21.78 − 0.101×age)×height for females) and optionally grade a measured VC as % predicted. Not medical advice.",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=vital-capacity-estimator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}List available tools
After connecting to the SSE endpoint, list the exposed tools:
tools/list
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Call this tool
Invoke the tool by its id, passing arguments built from its parameters:
tools/call
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "vital-capacity-estimator",
"arguments": {
"sex": "male",
"heightCm": 180,
"ageYears": 25,
"measuredVc": 0,
"measuredUnit": "L",
"decimalPlaces": 1
}
}
}Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).
Questions or issues? Contact [email protected]