Tools Reference Overview
Wellpipe provides 21 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
get-recent-sleeptool automatically - Receives your sleep data
- Provides a natural language response
Tool Categories
| Category | Tools | Description |
|---|---|---|
| Sleep | 4 | Sleep sessions, stages, and quality metrics |
| Recovery | 4 | Recovery scores, HRV, and readiness |
| Workout | 4 | Exercise activities and strain |
| Cycle | 4 | Daily strain and physiological cycles |
| Profile | 2 | User info and body measurements |
| Authentication | 3 | OAuth and connection management |
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.
Tool Naming Convention
Tools follow a consistent pattern:
get-{type}-collection- Paginated list with date filteringget-{type}-by-id- Single record by IDget-recent-{type}- Last N days (convenience)get-{type}-summary- Aggregated metrics for a date range
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 (get-recent-*):
- "How did I sleep last night?" →
get-recent-sleep - "What's my recovery today?" →
get-recent-recovery
Trend Analysis
Use summary tools (get-*-summary):
- "What's my average sleep this month?" →
get-sleep-summary - "How much strain have I accumulated?" →
get-workout-summary
Specific Records
Use by-ID tools (get-*-by-id):
- "Show me details for that workout" →
get-workout-by-id - "Get more info on yesterday's sleep" →
get-sleep-by-id
Date Range Queries
Use collection tools (get-*-collection):
- "Show all workouts in December" →
get-workout-collection - "Get sleep data from last month" →
get-sleep-collection
Next Steps
Explore each tool category: