Plugs an AI cycling coach directly into Claude Desktop or any MCP client. Four tools: generate a personalized 2-4 week training plan, get beginner guidance across 9 topics (bike selection, gear, first rides, nutrition), ask open-ended coaching questions in plain English, or submit any existing plan for structured critique. No API key required, no account signup. Works locally via stdio or through a hosted Railway endpoint at etapa-mcp-production.up.railway.app/mcp. Built for beginners and returning riders who want training advice without the jargon. The same backend powers an upcoming iOS app with Strava sync and 24-week periodized plans.
Public tool metadata for what this MCP can expose to an agent.
generate_training_planGenerate a 2-4 week cycling training plan using the **Etapa API** (getetapa.com). The plan is tailored to the rider's goal, fitness level, and available days. This is a sample plan — the full Etapa app supports plans up to 24 weeks with periodisation, real-time coach chat, and...7 paramsGenerate a 2-4 week cycling training plan using the **Etapa API** (getetapa.com). The plan is tailored to the rider's goal, fitness level, and available days. This is a sample plan — the full Etapa app supports plans up to 24 weeks with periodisation, real-time coach chat, and...
notesstringweeksintegergoalTypestringdaysPerWeekintegerfitnessLevelstringbeginner · intermediate · advancedindoorTrainerbooleantargetDistanceKmnumbercycling_beginner_guideGet generic beginner-friendly cycling guidance on topics like choosing your first bike, essential gear, your first ride, nutrition, safety on the road, bike fit, and building a habit. Call without a topic to see the full index. Content is curated — no API call is made.1 paramsGet generic beginner-friendly cycling guidance on topics like choosing your first bike, essential gear, your first ride, nutrition, safety on the road, bike fit, and building a habit. Call without a topic to see the full index. Content is curated — no API call is made.
topicstringgetting_started · first_bike · essential_gear · first_ride · nutrition_and_hydration · safetyAn AI cycling coach for beginners and every rider after that.
Etapa builds personalised cycling training plans in plain English — no jargon, no intimidation, no assumption that you already know what FTP means. The iOS app launches soon; in the meantime the coach is already available as an MCP server for any AI assistant.
The etapa-mcp package is an MCP server that plugs Etapa's cycling coach into any MCP-compatible AI assistant — Claude Desktop, Cursor, Windsurf, ChatGPT connectors, and more.
Four tools are exposed:
generate_training_plan — generates a personalised 2-4 week cycling training plan tailored to the rider's fitness level, goal, and available days.cycling_beginner_guide — returns curated, jargon-free guidance across 9 topics: choosing a first bike, essential gear, first rides, nutrition, road safety, bike fit, building a habit, and common beginner mistakes.ask_cycling_coach — open-ended Q&A with Etapa's AI cycling coach. Plan adaptations ("I missed a ride, what now?"), training theory, recovery advice — answered in plain English, no jargon.review_cycling_plan — give it any cycling plan (from another app, a book, a YouTube video, a coach) and get Etapa's honest structured critique.All tools are free, no account, no API key required.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"etapa": {
"command": "npx",
"args": ["-y", "etapa-mcp"]
}
}
}
Restart Claude Desktop, then ask:
"Use Etapa to build me a 3-week plan for my first 30 km ride."
If you don't want to install anything locally, point any MCP client at:
https://etapa-mcp-production.up.railway.app/mcp
Free, no auth required. Streamable HTTP transport.
| Transport | How to connect | Use case |
|---|---|---|
| stdio | npx -y etapa-mcp | Local AI assistants (Claude Desktop, Cursor, Windsurf) |
| streamable-http | https://etapa-mcp-production.up.railway.app/mcp | Web-based clients, ChatGPT custom connectors, programmatic integration |
Full MCP server source, development setup, and publishing flow: /mcp-server/.
A React Native / Expo app launching soon. Features:
Register interest here — we'll let you know the moment it's live.
All subscriptions include a 7-day free trial.
etapa/
├── src/ # React Native / Expo app (iOS + Android)
├── server/ # Node.js API (Railway)
├── mcp-server/ # MCP server (npm: etapa-mcp)
│ ├── README.md # technical docs
│ └── plan.md # MCP release state + distribution templates
├── admin-dashboard/ # Next.js admin panel
├── website/ # Static marketing site (Vercel)
│ └── blog/ # Long-form content for beginner cyclists
├── supabase/ # Database migrations + config
└── ios/ android/ # Native project files
Eight top-level docs covering everything you need to pick up where we left off:
| File | What it's for |
|---|---|
README.md | This file — repo landing page |
CLAUDE.md | Tech context for AI assistants |
brand.md | Brand bible — voice, tone, audience, visual style |
market-research.md | Competitive landscape + positioning research |
strategy.md | Marketing playbook — pillars, 30-day social launch plan, Holo production playbook, SEO content strategy. Everything about how we go to market. |
launch-plan.md | Launch runbook — 3-phase plan to get real users testing in 7 days, then public launch in 5 weeks. Includes every outreach template. |
founder-story.md | The founder narrative + the intro-video outline in one file. Read before recording the YouTube video. |
design-system.md | Design system — tokens, components, layout patterns, voice-in-UI. Paste at the top of any design chat with Claude. |
this-week.md | Rolling tactical file — the current week's Instagram content plan. Overwritten every Sunday. |
mcp-server/README.md | MCP technical docs + deployment + npm publishing |
mcp-server/plan.md | MCP release checkpoints + distribution templates (directory submissions, Reddit post, Show HN, etc.) |
MIT. See LICENSE for details.