Fitness
HRV-Based Recovery & Readiness Score
Scores today’s recovery 0-100 from morning HRV (rMSSD/SDNN) and resting heart rate z-scores against your own rolling baseline, blended with last night’s sleep and yesterday’s session RPE — with a green/amber/red tier, meaningful-change (0.5 SD) detection, baseline noise (CV) check, and an intensity-ceiling training recommendation.
Quick start
Call this tool from your code in three languages.
curl -X POST 'https://api.elysiatools.com/en/api/tools/hrv-recovery-readiness-score' \
-H 'Content-Type: application/json' \
-d '{"hrvMetric":"rmssd","todayHrv":52,"baselineHrv":"65\n55\n62\n58\n68\n52\n60\n64\n57\n61\n54\n66\n59\n63","todayRhr":57,"baselineRhr":"54\n53\n55\n54\n52\n54\n55\n53\n54\n55\n53\n54\n56\n54","yesterdayRpe":7.5,"sleepHours":5.5}'API reference
Send a POST request with your inputs as JSON. File parameters require a separate upload first.
Endpoint
POST https://api.elysiatools.com/en/api/tools/hrv-recovery-readiness-scoreParameters
| Name | Type | Required | Description |
|---|---|---|---|
| hrvMetric | select | Yes | — |
| todayHrv | number | Yes | — |
| baselineHrv | textarea | Yes | — |
| todayRhr | number | Yes | — |
| baselineRhr | textarea | No | — |
| yesterdayRpe |
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:
{
"mcpServers": {
"elysiatools-hrv-recovery-readiness-score": {
"name": "hrv-recovery-readiness-score",
"description": "Scores today’s recovery 0-100 from morning HRV (rMSSD/SDNN) and resting heart rate z-scores against your own rolling baseline, blended with last night’s sleep and yesterday’s session RPE — with a green/amber/red tier, meaningful-change (0.5 SD) detection, baseline noise (CV) check, and an intensity-ceiling training recommendation.",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=hrv-recovery-readiness-score",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}List available tools
After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Call this tool
Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "hrv-recovery-readiness-score",
"arguments": {
"hrvMetric": "rmssd",
"todayHrv": 52,
"baselineHrv": "65\n55\n62\n58\n68\n52\n60\n64\n57\n61\n54\n66\n59\n63",
"todayRhr": 57,
"baselineRhr": "54\n53\n55\n54\n52\n54\n55\n53\n54\n55\n53\n54\n56\n54",
"yesterdayRpe": 7.5,
"sleepHours": 5.5
}
}
}