extract_changelog
Read-only
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 }) => {