Hosted MCP Server

Connect AI assistants to a runner's training data over the Model Context Protocol.

Endpoint

https://api.coachicarus.com/mcp

The endpoint speaks Streamable HTTP. Initialize a session, call tools/list, then invoke tools. Every tool is read-only — the server never writes or modifies training data.

Authentication

Send a personal API key on every request as an X-API-Key header or a Bearer token. Generate one in the dashboard under Settings → API keys. Details in the authentication guide.

Tools — training data (free)

Nine tools, free with any Coach Icarus account.

`get_athlete_profile`	Athlete profile: age, sex, height, weight, max heart rate, training preferences.
`get_recent_activities`	Recent runs and workouts: date, distance, duration, pace, heart rate, elevation. Takes days_back (default 14).
`get_sleep_summary`	Nightly sleep summaries: duration, stages, quality score. Takes days_back (default 7).
`get_hrv_summary`	Nightly HRV summaries: last-night average and weekly average. Takes days_back (default 7).
`get_daily_metrics`	Daily summaries: resting heart rate, stress levels, steps, distance, calories. Takes days_back (default 7).
`get_activity_stats`	Aggregated stats over the period: totals, averages, trends. Takes days_back (default 28).
`get_training_load`	Current load: CTL (fitness), ATL (fatigue), TSB (form), weekly TSS.
`get_training_plan`	Upcoming workouts: date, type, distance/duration targets. Takes days_ahead (default 14).
`get_active_goal`	The athlete's active race goal: race type, date, target time.

Tools — coaching (Coach tier)

Three tools require the Coach tier. Free-tier callers receive a subscription_required tool error.

`get_run_debriefs`	Post-run coach debriefs: scores, tags, specialist analyses, plan adjustments. Takes count (default 1).
`get_recovery_status`	Today's recovery verdict: ready / caution / rest (or unknown when data is absent), with drivers and training guidance.
`get_weekly_briefing`	The coach's recovery-aware weekly briefing for the current plan week.

Client setup

Claude Code:

claude mcp add --transport http coach-icarus https://api.coachicarus.com/mcp --header "X-API-Key: ick_live_YOUR_KEY"

Claude Desktop / Cursor — MCP server configuration:

{
  "mcpServers": {
    "coach-icarus": {
      "url": "https://api.coachicarus.com/mcp",
      "headers": { "X-API-Key": "ick_live_YOUR_KEY" }
    }
  }
}

Rate limits

100 requests per minute per user. Exceeding the limit returns HTTP 429 — back off and retry.