Etapa

by rhoneybul

135 downloads
Not rated
GitHub

About

Etapa is an AI cycling coach for beginners. The MCP exposes two tools: `generate_training_plan` (2-4 week plans powered by the Etapa API) and `cycling_beginner_guide` (advice on bikes, gear, safety). Free, no account.

Details

Author
rhoneybul
Downloads
135
Categories
Other

- Exposes four AI-powered cycling coach tools
- Generates personalised 2-4 week training plans
- Provides jargon-free beginner cycling guidance
- Offers open-ended Q&A with the AI cycling coach
- Reviews any cycling plan with structured critique
- Free to use, no account or API key required

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Etapa
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the MCP server via npx -y etapa-mcp in your Claude Desktop configuration, or point any MCP client at the hosted HTTP endpoint https://etapa-mcp-production.up.railway.app/mcp. No account, API key, or local installation is required for the endpoint.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "etapa": {
            "etapa": {
                "command": "npx",
                "args": [
                    "-y",
                    "etapa-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "etapa": {
        "command": "npx",
        "args": [
            "-y",
            "etapa-mcp"
        ]
    }
}

MCP Server

npm version
MCP Registry
License: MIT

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.

What it does

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.

Quick install (Claude Desktop)

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."

Hosted HTTP endpoint

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 options

| 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 |

Source and documentation

Full MCP server source, development setup, and publishing flow: /mcp-server/.

---

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.