Skip to content
Watch Changelog Docs

Agent Workflows and MCP

AI agents and MCP-connected tools can subscribe to changelog streams and reason over product updates. “Which database vendors shipped Postgres 17 support this month?” becomes a structured query, not a web search.

Watch Changelog provides a stdio MCP server for agent workflows.

Why MCP for Changelogs

Section titled “Why MCP for Changelogs”

Agents need structured data, not markdown blog posts. The MCP server gives agents:

  • list_sources: Browse the catalog of 5000+ changelog sources
  • get_entries: Fetch entries for selected sources with plan-gated access
  • request_source: Request a missing vendor changelog

Same uniform JSON as the REST API, but via stdio protocol.

MCP Server Setup

Section titled “MCP Server Setup”

The MCP server is at mcp/server.ts in the repo. Run it locally with environment variables:

Terminal window
WATCHCHANGELOG_API_URL=https://watchchangelog.com \
WATCHCHANGELOG_API_KEY=wcl_your_key \
node mcp/server.ts

Configure your MCP client (Cline, Zed, Claude Desktop) to spawn this server as a subprocess. The server communicates over stdio, not HTTP.

See /api on the website or docs/mcp.md in the repository for setup details.

Agent Use Cases

Section titled “Agent Use Cases”

Competitive Research

Section titled “Competitive Research”

Agent prompt:

“Which edge compute vendors shipped GA features in August 2026?”

The agent calls list_sources to find edge vendor slugs, then get_entries with ?since=2026-08-01 and filters by changeKind: "ga".

Deprecation Alerts

Section titled “Deprecation Alerts”

Agent prompt:

“Show me all deprecations with hard deadlines in Q1 2027 for Shopify and Stripe.”

The agent queries entries for shopify-api-updates and stripe.changelog, filters by changeKind: "deprecation", and checks sunsetAt dates.

Release Notes Summary

Section titled “Release Notes Summary”

Agent prompt:

“Summarize what AWS Lambda shipped in the last 30 days.”

The agent calls get_entries with ?source=aws.lambda&since=2026-07-30 and generates a bullet list from the titles and summaries.

MCP Tools

Section titled “MCP Tools”

list_sources (public)

Section titled “list_sources (public)”

Returns the catalog of changelog sources. No API key required for the list. Free keys can list the whole catalog to pick their 3 sources.

get_entries (plan-gated)

Section titled “get_entries (plan-gated)”

Fetches changelog entries for selected sources. Requires API key. Free tier: 3 sources. All plan: whole catalog.

request_source (public)

Section titled “request_source (public)”

Submits a request for a missing vendor changelog. No API key required.

The All Plan Includes MCP

Section titled “The All Plan Includes MCP”

The All plan ($9.99/mo) includes:

  • Every source in the catalog
  • stdio MCP server
  • Uniform API access
  • Priority support

Free plan (3 sources) also works with MCP, but you only get entries for 3 sources.

Next

Section titled “Next”

Try the API Playground to test API calls with your wcl_ key before wiring them into an agent.