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.
• Report starts accept an Idempotency-Key header, as well as the body field idempotencyKey. See idempotency.
• Rate-limit 429 responses carry Retry-After and RateLimit-* headers; plan-limit 429s name the limit instead. See the two kinds of 429.
• The OpenAPI 3.1 description is published, and the API 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.
• Hosted: planned at https://mcp.recomention.com/mcp. Not live yet.

Docs

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