MCP 服务器

Transition MCP

AI-powered coaching for runners, cyclists, swimmers, and triathletes, enabling personalized workouts, training plan adaptation, performance analytics, and AI coaching via Claude, MCP clients, or HTTP.

README

Transition MCP

AI-powered coaching for runners, cyclists, swimmers, and triathletes. Get personalized workouts, training plan adaptation, performance analytics, and AI coaching — all accessible from Claude, MCP clients, or any HTTP client.

Quick Start

Try it right now — no API key needed:

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

For personalized features (your training plan, performance data, AI coach), you need a Transition account + API key. See Getting an API Key below.

Three Ways to Use This

1. Claude Code / OpenClaw Skill (Recommended)

The simplest option. Claude reads the skill file and calls the API directly — no binary, no MCP protocol, just HTTP. Also available on OpenClaw.

# Clone into your skills directory
git clone https://github.com/nftechie/transition-mcp.git ~/.claude/skills/transition-mcp

Set your API key:

# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)
export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

Now in Claude Code, you can say things like:

"What's my workout today?"
"Show me my fitness trend for the last month"
"Ask my coach if I should do intervals or rest today"
"Generate me a 30-minute swim workout"

Claude reads SKILL.md and knows how to call every endpoint.

2. MCP Server (Claude Desktop, Cursor, etc.)

For MCP-compatible clients. The server wraps the Transition API as MCP tools and resources.

Install:

cd mcp
go build -o transition-mcp .

Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "transition-mcp": {
      "command": "/absolute/path/to/transition-mcp",
      "env": {
        "TRANSITION_API_KEY": "tr_live_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. You'll see 6 tools and 3 resources available:

Tools:

Tool	Description
`get_todays_workout`	Today's scheduled workout
`get_week_plan`	7-day training plan
`adapt_plan`	Trigger plan adaptation
`get_fitness_metrics`	CTL/ATL/TSB performance data
`chat_with_coach`	AI endurance coach
`generate_workout`	Free Workout of the Day (no auth)

Resources:

Resource	Description
`transition://athlete/profile`	Goals, experience, preferences
`transition://athlete/recent-activities`	Last 14 days of workouts
`transition://athlete/performance`	FTP, thresholds, PMC data

3. Direct API

Use the API from scripts, automations, or any HTTP client. See SKILL.md for complete endpoint documentation with curl examples.

# Get this week's workouts
curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

# Ask the AI coach a question
curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "My left knee hurts after long runs. Should I adjust my plan?"}' \
  "https://api.transition.fun/api/v1/coach/chat"