WHOOP MCP Server for Vercel AI SDK 11 tools — connect in under 2 minutes
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect WHOOP through the Vinkius and every tool is available as a typed function — ready for React Server Components, API routes, or any Node.js backend.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token — get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using WHOOP, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About WHOOP MCP Server
Connect your WHOOP account to any AI agent and access your personal health data through natural conversation.
The Vercel AI SDK gives every WHOOP tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 11 tools through the Vinkius and stream results progressively to React, Svelte, or Vue components — works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
What you can do
- Profile — View your WHOOP profile and body measurements (height, weight, max HR)
- Cycles — Browse your 24-hour WHOOP cycles combining sleep, strain and recovery
- Sleep — Analyze sleep data with stages (light, deep, REM), duration and performance
- Recovery — Track recovery scores, HRV, resting heart rate and sleep balance
- Workouts — Review workout data with strain, heart rate zones, duration and calories
- Pagination — Navigate through historical data with date ranges and pagination tokens
The WHOOP MCP Server exposes 11 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect WHOOP to Vercel AI SDK via MCP
Follow these steps to integrate the WHOOP MCP Server with Vercel AI SDK.
Install dependencies
Run npm install @ai-sdk/mcp ai @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the script
Save to agent.ts and run with npx tsx agent.ts
Explore tools
The SDK discovers 11 tools from WHOOP and passes them to the LLM
Why Use Vercel AI SDK with the WHOOP MCP Server
Vercel AI SDK provides unique advantages when paired with WHOOP through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime — same WHOOP integration everywhere
Built-in streaming UI primitives let you display WHOOP tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
WHOOP + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the WHOOP MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query WHOOP in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate WHOOP tools and return structured JSON responses to any frontend
Chatbots with tool use: embed WHOOP capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with WHOOP through natural language queries
WHOOP MCP Tools for Vercel AI SDK (11)
These 11 tools become available when you connect WHOOP to Vercel AI SDK via MCP:
get_body_measurement
Useful for tracking physical metrics alongside your WHOOP data. Get your body measurement data
get_cycle
Includes sleep, recovery, strain and heart rate metrics for that 24-hour period. Get a specific WHOOP cycle by ID
get_cycle_recovery
Includes recovery score, resting heart rate, HRV (heart rate variability), sleep balance and strain balance. Get recovery data for a specific WHOOP cycle
get_cycle_sleep
Includes sleep duration, stages (light, deep, REM, awake), disturbances and sleep performance percentage. Get sleep data for a specific WHOOP cycle
get_cycles
Cycles represent 24-hour periods of recovery and strain data. Each cycle includes sleep, recovery, strain and heart rate metrics. Supports date range filtering with start/end in ISO 8601 format. Pagination: max 25 results, use nextToken for more. Get your WHOOP cycle data
get_profile
Use this to verify your authentication is working and get your user ID for other endpoints. Get your WHOOP profile info
get_recovery
Supports date range filtering. Pagination: max 25 results per request. Get your WHOOP recovery data
get_sleep
Supports date range filtering. Pagination: max 25 results. Get your WHOOP sleep data
get_sleep_by_id
Includes full sleep stages, disturbances, respiratory rate and sleep performance. Get a specific WHOOP sleep record by ID
get_workout
Includes strain score, duration, heart rate zones, calories burned and GPS data if available. Get a specific WHOOP workout by ID
get_workouts
Supports date range filtering. Pagination: max 25 results. Get your WHOOP workout data
Example Prompts for WHOOP in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with WHOOP immediately.
"Show me my recovery score from today."
"How did I sleep last night?"
"Show me my workouts from this week."
Troubleshooting WHOOP MCP Server with Vercel AI SDK
Common issues when connecting WHOOP to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpWHOOP + Vercel AI SDK FAQ
Common questions about integrating WHOOP MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Connect WHOOP with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect WHOOP to Vercel AI SDK
Get your token, paste the configuration, and start using 11 tools in under 2 minutes. No API key management needed.