Coach Icarus Developer API

Predictable, machine-readable resources for agents and integrations.

Coach Icarus combines a public discovery API with an authenticated API for account-specific training and recovery data. Start with the public endpoint to identify the product and available integrations; use a bearer access token only when you need private user data.

Hosted MCP server

Connect AI assistants to a runner's training data over the Model Context Protocol. Twelve read-only tools; authenticated with a personal API key.

https://api.coachicarus.com/mcp

Public agent API

Read-only product and capability discovery for agents. It contains no private user data and requires no token.

GET /api/v1/agent

OpenAPI schema

Machine-readable documentation for the public agent endpoint, available as JSON.

/api/openapi.json

Personal API keys & MCP access

Generate a personal API key in your Coach Icarus settings (dashboard → settings → API keys) and send it as an X-API-Key header or a Bearer token. The hosted MCP endpoint exposes twelve read-only tools — nine free, three Coach-tier — rate-limited to 100 requests per minute per user.

Quickstart walks through setup in three steps; the MCP server page documents every tool and client configuration.

Integration guides

Authentication guide explains bearer-token requirements. The Garmin webhook guide explains event types and secret handling.