extract_changelog

Extract version history and release notes from GitHub repositories, npm packages, or websites to track updates, maintenance activity, and feature releases.

Instructions

Extract update history from any product, repo, or package. Accepts a GitHub URL (uses Releases API), an npm package name, or any website URL (auto-discovers /changelog, /releases, /CHANGELOG.md). Returns version numbers, release dates, and entry content — all timestamped. Use this to check if a tool is actively maintained, when a feature shipped, or how fast a team moves.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`url`	Yes	GitHub repo URL (https://github.com/owner/repo), npm package name (e.g. 'freshcontext-mcp'), or any website URL (https://example.com). Auto-discovers changelog paths.
`max_length`	No	Max content length

Implementation Reference

src/adapters/changelog.ts:236-257 (handler)

The changelogAdapter function acts as the main entry point for the "extract_changelog" tool, routing the input to GitHub API, npm registry, or browser-based discovery based on the URL type.

export async function changelogAdapter(options: ExtractOptions): Promise<AdapterResult> {
  const input = (options.url ?? "").trim();
  const maxLength = options.maxLength ?? 6000;

  // npm package name (no http, no dots at start, no slashes)
  if (!input.startsWith("http") && !input.includes("/") && input.length > 0) {
    return fetchNpmChangelog(input, maxLength);
  }

  // GitHub repo URL → use releases API
  const ghMatch = input.match(/github\.com\/([^/]+)\/([^/?\s]+)/);
  if (ghMatch) {
    try {
      return await fetchGitHubReleases(ghMatch[1], ghMatch[2], maxLength);
    } catch {
      // Fall through to browser scrape if API fails
    }
  }

  // Any other URL → discover changelog
  return discoverChangelog(input, maxLength);
}

src/server.ts:242-255 (registration)

The "extract_changelog" tool is registered here with its schema and handler function in src/server.ts.

server.registerTool(
  "extract_changelog",
  {
    description:
      "Extract update history from any product, repo, or package. Accepts a GitHub URL (uses Releases API), an npm package name, or any website URL (auto-discovers /changelog, /releases, /CHANGELOG.md). Returns version numbers, release dates, and entry content — all timestamped. Use this to check if a tool is actively maintained, when a feature shipped, or how fast a team moves.",
    inputSchema: z.object({
      url: z.string().describe(
        "GitHub repo URL (https://github.com/owner/repo), npm package name (e.g. 'freshcontext-mcp'), or any website URL (https://example.com). Auto-discovers changelog paths."
      ),
      max_length: z.number().optional().default(6000).describe("Max content length"),
    }),
    annotations: { readOnlyHint: true, openWorldHint: true },
  },
  async ({ url, max_length }) => {

freshcontext-mcp