{
  "markdown": "# Transition MCP\n\nAI-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.\n\nPowered by **[Transition](https://www.transition.fun)**\n\n## Quick Start\n\nTry it right now — no API key needed:\n\n```bash\ncurl \"https://api.transition.fun/api/v1/wod?sport=run&duration=45\"\n```\n\nFor personalized features (your training plan, performance data, AI coach), you need a Transition account + API key. See [Getting an API Key](#getting-an-api-key) below.\n\n---\n\n## Three Ways to Use This\n\n### 1. Claude Code / OpenClaw Skill (Recommended)\n\nThe simplest option. Claude reads the skill file and calls the API directly — no binary, no MCP protocol, just HTTP. Also available on [OpenClaw](https://openclaw.com).\n\n```bash\n# Clone into your skills directory\ngit clone https://github.com/nftechie/transition-mcp.git ~/.claude/skills/transition-mcp\n```\n\nSet your API key:\n\n```bash\n# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)\nexport TRANSITION_API_KEY=\"tr_live_xxxxxxxxxxxxxxxxxxxxx\"\n```\n\nNow in Claude Code, you can say things like:\n- \"What's my workout today?\"\n- \"Show me my fitness trend for the last month\"\n- \"Ask my coach if I should do intervals or rest today\"\n- \"Generate me a 30-minute swim workout\"\n\nClaude reads `SKILL.md` and knows how to call every endpoint.\n\n### 2. MCP Server (Claude Desktop, Cursor, etc.)\n\nFor MCP-compatible clients. The server wraps the Transition API as MCP tools and resources.\n\n**Install:**\n\n```bash\ncd mcp\ngo build -o transition-mcp .\n```\n\n**Configure Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"transition-mcp\": {\n      \"command\": \"/absolute/path/to/transition-mcp\",\n      \"env\": {\n        \"TRANSITION_API_KEY\": \"tr_live_xxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You'll see 6 tools and 3 resources available:\n\n**Tools:**\n| Tool | Description |\n|------|-------------|\n| `get_todays_workout` | Today's scheduled workout |\n| `get_week_plan` | 7-day training plan |\n| `adapt_plan` | Trigger plan adaptation |\n| `get_fitness_metrics` | CTL/ATL/TSB performance data |\n| `chat_with_coach` | AI endurance coach |\n| `generate_workout` | Free Workout of the Day (no auth) |\n\n**Resources:**\n| Resource | Description |\n|----------|-------------|\n| `transition://athlete/profile` | Goals, experience, preferences |\n| `transition://athlete/recent-activities` | Last 14 days of workouts |\n| `transition://athlete/performance` | FTP, thresholds, PMC data |\n\n### 3. Direct API\n\nUse the API from scripts, automations, or any HTTP client. See [SKILL.md](SKILL.md) for complete endpoint documentation with curl examples.\n\n```bash\n# Get this week's workouts\ncurl -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  \"https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15\"\n\n# Ask the AI coach a question\ncurl -X POST -H \"X-API-Key: $TRANSITION_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"message\": \"My left knee hurts after long runs. Should I adjust my plan?\"}' \\\n  \"https://api.transition.fun/api/v1/coach/chat\"\n```\n\n---\n\n## Getting an API Key\n\n1. Download [Transition](https://www.transition.fun) (iOS/Android)\n2. Create an account and complete onboarding\n3. Go to **Settings > API Keys**\n4. Tap **Generate New Key** — you'll see a key starting with `tr_live_`\n5. Copy it immediately (it's only shown once)\n\nFree tier includes 100 read requests/day and 3 AI requests/day. Plenty for personal use.\n\n## Rate Limits\n\n| Tier | Read Endpoints | AI Endpoints |\n|------|---------------|-------------|\n| Free | 100/day | 3/day |\n| Paid | 10,000/day | 100/day |\n\n**Read:** workouts, metrics, profile, history | **AI:** coach chat, adapt, generate\n\n---\n\n## Examples\n\nSee the [`examples/`](examples/) directory for scripts:\n- `curl-examples.sh` — All endpoints with curl\n- More coming soon\n\n## License\n\nMIT\n",
  "bytes": 3999,
  "sha": "b762128a46c62d651b66f9828fd09b456f415c1770df431549306d92e876c1b8",
  "repo_slug": "nftechie/transition-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nftechie_transition_mcp_1e5c12bb/readme"
}