# releases.sh

> The latest product releases, indexed for agents. Releases tracks release notes, changelogs, and version updates across hundreds of developer tools and services, normalizes them into one registry, and serves them over a REST API, a hosted MCP server, an open-source CLI, and this site. Most reads are public — no account or API key required.

Quick facts:

- REST API base URL: `https://api.releases.sh/v1`. OpenAPI 3.1 spec: https://api.releases.sh/v1/openapi.json. Interactive reference: https://api.releases.sh/v1/docs.
- Hosted MCP server (Streamable HTTP, read tools public, no key): `https://mcp.releases.sh/mcp`. Claude Code: `claude mcp add --transport http releases https://mcp.releases.sh/mcp`.
- CLI: `npm install -g @buildinternet/releases` (or `brew install buildinternet/tap/releases`). Agent skills: `npx skills add buildinternet/releases-cli`.
- Links below point to Markdown versions of each page. Any page on this site is also available as Markdown by appending `.md` to its URL (for example, https://releases.sh/docs/installation.md) or by sending `Accept: text/markdown` to the canonical URL.
- Org and source pages have machine-readable suffixes — `.md` (LLM-friendly), `.json`, `.atom` — e.g. https://releases.sh/anthropic.md.

## Introduction

- [Why](https://releases.sh/docs/why.md): Releases is changelog infrastructure built for agents — the Context7-equivalent for what shipped. One registry across GitHub releases, CHANGELOG files, marketing blogs, RSS, and more.

## Getting Started

- [Overview](https://releases.sh/docs.md): Overview of Releases — a changelog index with a CLI, REST API, MCP server, and agent skills.
- [Installation](https://releases.sh/docs/installation.md): Install the Releases CLI via Homebrew, npm, a one-line script, or precompiled binaries from GitHub Releases.
- [Skills](https://releases.sh/docs/skills.md): Install Releases skills — auto-triggering playbooks that teach Claude Code, Codex, Cursor, and OpenCode how to use the CLI and MCP tools.
- [Examples](https://releases.sh/docs/examples.md): Common CLI workflows for browsing, searching, and tracking releases.

## For Owners

- [Get Listed](https://releases.sh/docs/listing.md): One small file that tells the Releases registry — and any agent — where you publish product updates. Point at your changelog, feed, or GitHub releases.

## Integrations

- [Slack](https://releases.sh/docs/integrations/slack.md): Post new releases to a Slack channel whenever something you follow ships.

## CLI

- [Browsing & Search](https://releases.sh/docs/cli/browsing.md): CLI commands for listing, searching, and inspecting orgs, sources, and releases.

## API

- [REST API](https://releases.sh/docs/api/rest.md): HTTP endpoints for browsing orgs, sources, and releases in the index.
- [Errors](https://releases.sh/docs/api/errors.md): The standardized error envelope, error types, and common error codes returned by the REST API.
- [Webhooks](https://releases.sh/docs/api/webhooks.md): Receive release.created events over HTTPS — org-scoped or filtered by your follows.
- [MCP Server](https://releases.sh/docs/api/mcp.md): Use Releases as an MCP tool server from Claude, Cursor, and other agents.

## About

- [Privacy & Telemetry](https://releases.sh/docs/privacy.md): What the CLI and local MCP server collect, how to inspect it, and how to opt out.

## Machine-readable endpoints

- [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json): Every public REST endpoint's request and response shapes — the source of truth.
- [Agent authentication guide](https://releases.sh/auth.md): OAuth 2.0 / OIDC discovery and token how-to for the few write paths; public reads need none.
- [MCP server card](https://releases.sh/.well-known/mcp/server-card.json): Machine-readable description of the hosted MCP server.
- [Agent skills index](https://releases.sh/.well-known/agent-skills/index.json): Discovery document for the installable agent skills.
- [API catalog](https://releases.sh/.well-known/api-catalog): RFC 9727 catalog advertising the REST API.
- [releases.json schema](https://releases.sh/schemas/releases.json): JSON Schema for the owner-published manifest declaring products and release-note locations (see Get Listed above).

## Optional

- [llms-full.txt](https://releases.sh/llms-full.txt): All documentation pages concatenated into one file, for single-context ingestion.
- [CLI source repository](https://github.com/buildinternet/releases-cli): The open-source CLI, agent skills, and Claude Code plugins.
- [MCP Registry listing](https://registry.modelcontextprotocol.io/v0.1/servers?search=sh.releases/mcp): The hosted server's entry in the official MCP Registry (`sh.releases/mcp`).