Havoptic API Documentation
All Havoptic data is publicly accessible without authentication. Use these endpoints to programmatically access release data, feature comparisons, and feeds for AI coding tools.
MCP Server
Havoptic is queryable directly from AI assistants via the Model Context Protocol. Remote MCP server: https://mcp.havoptic.com/mcp (streamable HTTP transport, read-only, no authentication). Connect from Claude Code: claude mcp add --transport http havoptic https://mcp.havoptic.com/mcp
MCP tools: list_tracked_tools, latest_releases, get_release, release_history, search_release_notes, cadence_stats, compare_tools, feature_timeline.
REST API (v1)
- GET /api/v1/releases - Filterable, paginated release list. Params: tool, type, since, until, q, limit (max 100), offset. Cache: 5 min.
- GET /api/v1/releases/{id} - One release by id with full release notes.
- GET /api/v1/tools - Tracked tools with release counts and latest release.
- GET /api/v1/tools/{id}/cadence - Release cadence stats (7/30/90-day counts, average gap).
- GET /api/v1/compare?tools=a,b - Cadence, feature differences, and editorial verdict for a tool pair.
- GET /api/v1/feature-timeline - Who shipped each notable cross-tool feature first, with follower lag.
Bulk Datasets and Feeds
- GET /data/releases.json - All tracked AI coding tool releases with version, date, summary, and full notes. Updated daily. Cache: 1 hour.
- GET /data/feature-matrix.json - Feature comparison matrix across all tracked tools. Cache: 24 hours.
- GET /feed.xml - RSS 2.0 feed of the 50 most recent releases. Cache: 1 hour.
- GET /feed.json - JSON Feed 1.1 of the 50 most recent releases. Cache: 1 hour.
- GET /llms.txt - Structured site description for AI assistants. Cache: 24 hours.
- GET /llms-full.txt - Extended LLM context with feature matrix, recent releases, and FAQ. Cache: 1 hour.
- GET /.well-known/agents.json - Machine-readable agent discovery file. Cache: 24 hours.
Tool Identifiers
Use these IDs to filter releases by tool: claude-code, openai-codex, cursor, gemini-cli, kiro, github-copilot, windsurf, antigravity-cli.
Rate Limits
60 requests per minute. No authentication required. Please cache responses where possible.
For AI Agents
Live queries: MCP server at https://mcp.havoptic.com/mcp. Machine-readable discovery files are available at /.well-known/agents.json, /llms.txt, and /llms-full.txt. OpenAPI spec: /openapi.json.