# Changelog

## API v1 on its own host

**`https://api.recomention.com/v1`** is the base URL for API v1.

- Every endpoint is under `/v1`: rankings, reports, report status, the report itself and the Distribution Kit. See the [API reference](/reference/).
- Report starts accept an `Idempotency-Key` header, as well as the body field `idempotencyKey`. See [idempotency](/rate-limits/#idempotency-retry-a-start-safely).
- Rate-limit `429` responses carry `Retry-After` and `RateLimit-*` headers; plan-limit `429`s name the `limit` instead. See [the two kinds of 429](/rate-limits/#when-you-hit-one).
- The OpenAPI 3.1 description is published, and the [API reference](/reference/) is generated from it.

### Deprecated: `https://www.recomention.com/api/v1`

The original base, `https://www.recomention.com/api/v1`, still answers as an alias of v1, so existing scripts keep working. It is deprecated: move to `https://api.recomention.com/v1`. The paths are the same after the base — `https://www.recomention.com/api/v1/reports` becomes `https://api.recomention.com/v1/reports`. Responses from the old base carry a `Deprecation` header and a `Link: <…>; rel="successor-version"` header pointing at the same endpoint on the new host. The old base never redirects, because a cross-origin redirect would drop your `Authorization` header. A removal date will be announced here first.

## MCP server

- **stdio:** `@recomention/mcp` for Claude Code, Cursor and Codex, with four agent skills. Publishing to npm soon. See [MCP server](/mcp/).
- **Hosted:** planned at `https://mcp.recomention.com/mcp`. Not live yet.

## Docs

- These docs launched at [https://docs.recomention.com](https://docs.recomention.com), with [llms.txt](/llms.txt) and [llms-full.txt](/llms-full.txt) for agents and a Copy Markdown button on every guide.