releasebot

Releasebot

Lightweight command-line and MCP access to the Releasebot catalog: read release notes, changelogs, and product announcements from your terminal or as context for any AI agent.

This repo publishes two packages:

Package	What it is	Install
@releasebot-io/cli	CLI (binary: releasebot)	npm i -g @releasebot-io/cli
@releasebot-io/mcp	MCP server for AI agents	npx -y @releasebot-io/mcp

Getting an API key

First, sign up for a Releasebot account at https://releasebot.io/sign-up

Then, generate a key at https://releasebot.io/notifications. Keys look like rb_ followed by 32 characters. Free accounts start with 250 API credits.

• search and follows are free (no credits charged).
• releases, search-releases, all, and feed charge 1 credit per release returned (min 1 credit per request).
• Responses include an X-Credits-Remaining header; a 402 means you're out (upgrade at https://releasebot.io/billing).

Plan	Credits / month
Free	250
Pro	5,000
Max	Unlimited

---

CLI

npm install -g @releasebot-io/cli
# or run without installing:
npx @releasebot-io/cli search openai

Authenticate

releasebot auth set rb_your_api_key   # saved to ~/.releasebot/credentials.json (mode 0600)
releasebot auth status

You can also set RELEASEBOT_API_KEY in your environment instead of saving a file. The env var takes precedence.

Commands

# Search for vendors or products. Returns a list of matches which can be used to return releases.
releasebot search "github"

# Keyword search across all release notes (any vendor/product)
releasebot search-releases "dark mode"
releasebot grep "CVE-2024" --limit 50   # 'grep' is an alias

# Return recent releases for a vendor
releasebot releases openai

# Return recent releases for a specific product (vendor-slug/product-slug)
releasebot releases openai/chatgpt --limit 20

# Return releases on or before a date
releasebot releases apple --before 2025-01-01

# Return releases discovered on or after a date (e.g. everything since your last check)
releasebot feed --since 2026-06-30

# All releases across every vendor/product, newest-first
releasebot all --limit 50

# Your followed feed (vendors/products you follow on releasebot.io)
releasebot feed

# List the vendors and products you explicitly follow (free)
releasebot follows
releasebot follows --limit 100 --offset 20 --json

Every data command supports --json for raw output (and emits bare TSV when piped), plus -l/--limit <n>. The follows command also accepts --offset <n> for pagination; pass the response’s nextOffset as the next offset (null means the end). It returns explicit follows without expanding vendor follows into products. The release commands (releases, search-releases, all, feed) also accept --before <date> and --since <date> filters.

releasebot releases openai --json | jq '.releases[].slug'

---

MCP Server

MCP access is also available via our hosted server at https://releasebot.io/mcp

Add Releasebot to any MCP client. Example for Claude Desktop / Cursor (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "releasebot": {
      "command": "npx",
      "args": ["-y", "@releasebot-io/mcp"],
      "env": { "RELEASEBOT_API_KEY": "rb_your_api_key" }
    }
  }
}

If you've already run releasebot auth set, the server picks up the key from ~/.releasebot/credentials.json and you can omit the env block.

Tools

• search_vendor — search vendors and products by keyword. Args: query (required), maxResults, pageOffset.
• search_releases — list recent releases scoped to a vendor/product. Provide at least one of vendorSlug, vendorId, productSlug, productId. Optional: limit, offset, before, since.
• search_release_content — general keyword search across all release notes (any vendor/product), newest-first. Args: query (required), limit, offset, before, since.
• list_follows — list the vendors and products you explicitly follow, with IDs, slugs, names, and parent vendor details for products. Free, including at zero credits. Args: limit (default 20, max 100), offset. Returns follows, nextOffset, and page total; pass nextOffset as the next offset until it is null.
• my_feed — list recent releases from your followed feed (the vendors/products you follow on releasebot.io). Resolved from your API key — no vendor/product/id. Args: limit, offset, before, since.

---

Configuration

Variable	Purpose
RELEASEBOT_API_KEY	API key (overrides the saved credentials file)
RELEASEBOT_API_URL	Override the API base URL (default https://releasebot.io/api/v1)

---

Development

This is a pnpm workspace.

pnpm install
pnpm build       # builds lib, then mcp + cli
pnpm typecheck

• packages/lib (@releasebot-io/lib) is a private, unpublished helper holding the shared API client and types. It is bundled into the CLI and MCP outputs at build time.
• packages/mcp and packages/cli are published to npm.

License

MIT