Tools Reference Overview
Wellpipe provides MCP (Model Context Protocol) tools that AI assistants can use to access your health data. These tools are automatically available when you connect Wellpipe to Claude Desktop or other MCP-compatible assistants.
What Are MCP Tools?
MCP tools let AI assistants perform specific actions. Instead of you copying and pasting data, the AI can directly call these tools to fetch your health information.
When you ask "How did I sleep last night?", Claude:
- Recognizes this is a sleep question
- Calls the
whoop-get-recent-sleeptool automatically - Receives your sleep data
- Provides a natural language response
Available Providers
| Provider | Tools | Description |
|---|---|---|
| WHOOP | 18 | Sleep, recovery, workouts, cycles, profile |
| Garmin | 32 | Sleep, heart rate, HRV, activities, body composition |
Tool Naming Convention
Tools are prefixed by provider to avoid conflicts:
whoop-get-{type}-collection- Paginated list with date filteringwhoop-get-{type}-by-id- Single record by IDwhoop-get-recent-{type}- Last N days (convenience)whoop-get-{type}-summary- Aggregated metrics for a date range
Similarly for Garmin:
garmin-get-{type}- Fetch data with date filteringgarmin-get-{type}-summary- Aggregated metrics
Common Parameters
Many tools share common parameters:
Date Filtering
| Parameter | Type | Example | Description |
|---|---|---|---|
start_date | string | 2024-12-01T00:00:00.000Z | Start of date range (ISO 8601) |
end_date | string | 2024-12-15T23:59:59.000Z | End of date range (ISO 8601) |
days | number | 7 | Days to look back (convenience alternative) |
Pagination
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 25 | Maximum records to return (max: 25) |
Responses include a next_token field for pagination. Summary tools automatically handle pagination to include all data.
Understanding Time Values
WHOOP returns durations in milliseconds. Summary tools convert these to hours for readability.
hours = milliseconds / 3,600,000
For example: 7200000 ms = 2 hours
Score States
Most health data has a score_state field:
| State | Description |
|---|---|
SCORED | Complete analysis available |
PENDING_SCORE | Data being processed |
UNSCORABLE | Insufficient data for scoring |
Only SCORED records have full metrics.
When to Use Each Tool
Quick Questions
Use convenience tools (whoop-get-recent-*):
- "How did I sleep last night?" →
whoop-get-recent-sleep - "What's my recovery today?" →
whoop-get-recent-recovery
Trend Analysis
Use summary tools (whoop-get-*-summary):
- "What's my average sleep this month?" →
whoop-get-sleep-summary - "How much strain have I accumulated?" →
whoop-get-workout-summary
Specific Records
Use by-ID tools (whoop-get-*-by-id):
- "Show me details for that workout" →
whoop-get-workout-by-id - "Get more info on yesterday's sleep" →
whoop-get-sleep-by-id
Date Range Queries
Use collection tools (whoop-get-*-collection):
- "Show all workouts in December" →
whoop-get-workout-collection - "Get sleep data from last month" →
whoop-get-sleep-collection
Next Steps
Explore the available tools: