coach steve for developers

coach steve is an AI running coach by text message. Its public facts, prices and running guides are open to programs and agents three ways: a REST API, two MCP servers and Markdown copies of every page.

All of it is read only. Nothing here reads or changes an athlete’s data, signs anyone up, sends a text or takes a payment.

• OpenAPI 3.1 spec
• API catalog (RFC 9727)
• Site index for agents (llms.txt)

No key and no sign-up: call the API straight away.

curl https://getcoachsteve.com/api/v1/pricing
curl "https://getcoachsteve.com/api/v1/articles?query=marathon+pace&limit=3"
curl https://getcoachsteve.com/api/v1/articles/best-ai-running-coaches

Base URL https://getcoachsteve.com/api/v1. GET /info gives what coach steve is and how to get started; GET /pricing the current prices in USD; GET /articles searches the guides, comparisons and calculators by words (query, section, limit up to 25); GET /articles/{slug} returns one article in full as Markdown.

Answers are JSON and open to any origin (CORS). They may be cached for up to an hour. The API is versioned in its path: a change that breaks a client gets a new version, /api/v2, and v1 keeps answering. Before a version is retired, its answers carry Deprecation and Sunset headers for at least six months, and this page says so.

Running and triathlon races worldwide, read only and free under CC BY 4.0: search, one race by id or slug, counts by filter, a change feed and the whole index as a nightly download. It has its own OpenAPI spec and guide, and the product MCP server offers search_races and get_race while the index is available.

• Race API guide
• Race API OpenAPI spec

The product server at https://getcoachsteve.com/mcp (Streamable HTTP) offers get_coach_steve_info, get_coach_steve_pricing, search_running_guides and get_running_guide. get_coach_steve_info also opens an MCP App in hosts that support one.

The docs server at https://getcoachsteve.com/mcp/docs offers search_docs and get_doc over this guide, the authentication notes, the API spec and the running guides.

Every tool is read only. A bad call answers with a JSON-RPC error that says which argument is wrong.

• Product server card
• Docs server card

Every guide, comparison and tool page has a Markdown twin: add .md to its address, such as /guides/marathon-pace-chart.md, or ask for the page with Accept: text/markdown. The homepage, pricing and this page answer the same way, and /?mode=agent gives the homepage’s agent view. Each Markdown copy opens with frontmatter: title, description, canonical address and last update.

Each section has its own index: /guides/llms.txt, /compare/llms.txt, /tools/llms.txt and, for the API, /api/llms.txt.

None. Every public endpoint and tool is anonymous: there is no API key, OAuth flow or account to create, and no Authorization header to send.

• auth.md

Every refusal is JSON with a code to switch on, a message and a hint: {"error": {"code": "invalid_limit", "message": "...", "hint": "...", "field": "limit"}}. Codes: not_found (404), method_not_allowed (405), invalid_query, invalid_section and invalid_limit (400). Any address under /api that does not exist answers not_found in JSON.

There is no separate sandbox because nothing here can change anything: every endpoint and tool only reads public pages. Call the live API as often as you need while you build.

There is no hard rate limit today; please keep to a few requests a second. Questions and bug reports: sam@palisade.email.

• Contact