mcp-internet-archive 1.0.0 → 3.0.1

package/CHANGELOG.md

@@ -0,0 +1,155 @@
+## [3.0.1](https://github.com/Mearman/mcp-wayback-machine/compare/v3.0.0...v3.0.1) (2026-05-09)
+
+### Chores
+
+* enable dependabot auto-merge for passing PRs ([1453f3e](https://github.com/Mearman/mcp-wayback-machine/commit/1453f3e93a4bd759c950c5b19fc805b32ce9562c))
+
+## [3.0.0](https://github.com/Mearman/mcp-wayback-machine/compare/v2.2.0...v3.0.0) (2026-05-09)
+
+### ⚠ BREAKING CHANGES
+
+* v3.0.0 major release - complete toolchain migration
+from Yarn/Biome to pnpm/ESLint, native Node type stripping, DI-based
+tool architecture, per-endpoint cache TTLs, SPN2 advanced options,
+CDX advanced features, and MCP Registry integration.
+
+### Bug Fixes
+
+* correct mcpName to match GitHub repo name ([7ad4e45](https://github.com/Mearman/mcp-wayback-machine/commit/7ad4e453653e3ae41176c6fc77b7a200f4c75385))
+
+## [2.2.0](https://github.com/Mearman/mcp-wayback-machine/compare/v2.1.1...v2.2.0) (2026-05-09)
+
+### Features
+
+* add cache management, screenshot listing, and snapshot comparison tools ([cd8c122](https://github.com/Mearman/mcp-wayback-machine/commit/cd8c122ca8ba618386b75638dc56dc0f9cbd45a5))
+* add server.json generation script for MCP Registry ([a578da7](https://github.com/Mearman/mcp-wayback-machine/commit/a578da74e72a75caa2cbf45ed2e0ea1403e24e16))
+* migrate toolchain and rewrite for strict TypeScript ([008434e](https://github.com/Mearman/mcp-wayback-machine/commit/008434ebac4216d3e30de7083c22100bbcf9fb5a))
+
+### Refactoring
+
+* extract shared response schemas ([9bf978d](https://github.com/Mearman/mcp-wayback-machine/commit/9bf978dc99455aa957db8027a96504b35b2af3be))
+
+### Documentation
+
+* update readme for v2 feature set ([e315381](https://github.com/Mearman/mcp-wayback-machine/commit/e315381f72b0af043e32695459202ad8437148c5))
+
+### Tests
+
+* cover SPN2 options and CDX advanced features ([09e50a0](https://github.com/Mearman/mcp-wayback-machine/commit/09e50a0bbea5a41246adaab2be8f393b74e19fe8))
+
+### Chores
+
+* remove tsconfig.tests.json ([e683d44](https://github.com/Mearman/mcp-wayback-machine/commit/e683d4454ada39dd53274a74cc38c2ea547bc839))
+
+## [2.1.1](https://github.com/Mearman/mcp-wayback-machine/compare/v2.1.0...v2.1.1) (2026-05-09)
+
+### Bug Fixes
+
+* disable provenance for GitHub Packages publish ([112607c](https://github.com/Mearman/mcp-wayback-machine/commit/112607c3902db407b03cdb556a3afc3ff7f58df3))
+
+## [2.1.0](https://github.com/Mearman/mcp-wayback-machine/compare/v2.0.0...v2.1.0) (2026-05-09)
+
+### Features
+
+* add in-memory and disk request caching for read operations ([d901348](https://github.com/Mearman/mcp-wayback-machine/commit/d90134856936bd2e39c71692ad978a13098d3b49))
+
+### Bug Fixes
+
+* pass NPM_TOKEN to semantic-release for npm auth verification ([043c694](https://github.com/Mearman/mcp-wayback-machine/commit/043c694312e34b3a563a419245e1b9e945a92259))
+* propagate semantic-release exit code in CI release step ([d34008d](https://github.com/Mearman/mcp-wayback-machine/commit/d34008dbeb663383908828c66dbd8008f2972bf7))
+* split eslint config into per-context tsconfig resolution ([54a33db](https://github.com/Mearman/mcp-wayback-machine/commit/54a33dbb84b87ab1c223f31822a9cb495188f220))
+
+### Refactoring
+
+* rewrite source for strict typescript and eslint compliance ([58a8415](https://github.com/Mearman/mcp-wayback-machine/commit/58a8415595eff5827143d59075fcdd2b9582d27b)), closes [#3](https://github.com/Mearman/mcp-wayback-machine/issues/3) [#18](https://github.com/Mearman/mcp-wayback-machine/issues/18)
+
+### Documentation
+
+* update README for pnpm, caching, and Node 22+ ([68c2156](https://github.com/Mearman/mcp-wayback-machine/commit/68c2156b31b33a0ed20323956b140d1087f48130))
+
+### Tests
+
+* add node:test suite with 80% coverage threshold ([97443ba](https://github.com/Mearman/mcp-wayback-machine/commit/97443bace96a552bf271858004313f8478be3215))
+
+### CI
+
+* add GitHub Packages publishing alongside npmjs ([ab58f25](https://github.com/Mearman/mcp-wayback-machine/commit/ab58f25a1a1a4e7d02213a4d4f09ba30052cfa5c))
+* rewrite workflow for pnpm, matrix builds, and OIDC publishing ([0dcf8e5](https://github.com/Mearman/mcp-wayback-machine/commit/0dcf8e57cfc2b5c08f8ebe890cfb59e775e516d7))
+
+### Chores
+
+* migrate toolchain from yarn/biome to pnpm/eslint/turbo ([26dac1c](https://github.com/Mearman/mcp-wayback-machine/commit/26dac1c557e8704f68bb9e03713a8d7a7cfadc73))
+* remove stale workflows, template artifacts, and vitest tests ([928d87b](https://github.com/Mearman/mcp-wayback-machine/commit/928d87b97046e3c01ce0a3ec9d35c8ef43b844df))
+
+# [2.0.0](https://github.com/Mearman/mcp-wayback-machine/compare/v1.0.4...v2.0.0) (2025-06-05)
+
+
+### Bug Fixes
+
+* replace GitHub license badge with CC BY-NC-SA 4.0 badge ([feda5a0](https://github.com/Mearman/mcp-wayback-machine/commit/feda5a0d5ee7807475118af8b2c123c4668c29f2))
+
+
+### Features
+
+* add CLI support for direct command-line usage ([94a1bf8](https://github.com/Mearman/mcp-wayback-machine/commit/94a1bf8e3dd8386b29e67bd5295f68b2f63e7d98))
+
+
+### BREAKING CHANGES
+
+* The tool now checks for CLI arguments and will run in CLI mode if any are provided
+
+## [1.0.4](https://github.com/Mearman/mcp-wayback-machine/compare/v1.0.3...v1.0.4) (2025-06-04)
+
+
+### Bug Fixes
+
+* use lowercase package name and correct registry for GitHub Packages ([0a3b4ba](https://github.com/Mearman/mcp-wayback-machine/commit/0a3b4ba9958f1680245eb5b5b30f84ff82475631))
+
+## [1.0.3](https://github.com/Mearman/mcp-wayback-machine/compare/v1.0.2...v1.0.3) (2025-06-04)
+
+
+### Bug Fixes
+
+* skip prepublishOnly script for GitHub Packages publish ([25c3c3f](https://github.com/Mearman/mcp-wayback-machine/commit/25c3c3fc104f7c0c55cf4a8e9bf3d5952aa91884))
+
+## [1.0.2](https://github.com/Mearman/mcp-wayback-machine/compare/v1.0.1...v1.0.2) (2025-06-04)
+
+
+### Bug Fixes
+
+* add version detection for GitHub Packages publishing ([4298868](https://github.com/Mearman/mcp-wayback-machine/commit/429886820cb90238249fdf8563c203fff55f5382))
+
+## [1.0.1](https://github.com/Mearman/mcp-wayback-machine/compare/v1.0.0...v1.0.1) (2025-06-04)
+
+
+### Bug Fixes
+
+* restore bin field as object for proper CLI naming ([ab966b2](https://github.com/Mearman/mcp-wayback-machine/commit/ab966b28b01ecd1938a3cf3640922ab7e0d24a16))
+
+# 1.0.0 (2025-06-04)
+
+
+### Bug Fixes
+
+* add packageManager field for Yarn 4 compatibility ([dc1de05](https://github.com/Mearman/mcp-wayback-machine/commit/dc1de05a1a856fd666d9c7711626c664fe249c19))
+* convert bin field to object format for npm compatibility ([9f5ee8a](https://github.com/Mearman/mcp-wayback-machine/commit/9f5ee8ad7b1b1ae4c0cabc6ed5109aaea9b50073))
+* resolve test failures and version compatibility issues ([6b682aa](https://github.com/Mearman/mcp-wayback-machine/commit/6b682aa4569693209f7673112c13bc860021acac))
+* resolve timeout test race condition ([8a6dea1](https://github.com/Mearman/mcp-wayback-machine/commit/8a6dea17ced800eb6bf9826be3473aa767406db6))
+* resolve TypeScript errors in test files ([2877988](https://github.com/Mearman/mcp-wayback-machine/commit/2877988733d6010f1a5e98a1e51760f8c71b63ee))
+* use space indentation for markdown files ([58b359b](https://github.com/Mearman/mcp-wayback-machine/commit/58b359b7dc2b561aba1cc45ef95405d87825756d))
+
+
+### Features
+
+* add bin field to enable npx invocation ([1c48881](https://github.com/Mearman/mcp-wayback-machine/commit/1c48881effe427cf3b9bacd9ce32f78912d1a267))
+* apply CC BY-NC-SA 4.0 license with full license file and README badge ([e8c9980](https://github.com/Mearman/mcp-wayback-machine/commit/e8c998056d3e9cbca272204d83c905478a7c9fc6))
+* implement initial MCP server with tool definitions ([377b6e0](https://github.com/Mearman/mcp-wayback-machine/commit/377b6e02773f8ad59115f0097a69201ea8028e84))
+* implement Wayback Machine API integration ([14d70c1](https://github.com/Mearman/mcp-wayback-machine/commit/14d70c1161e0a8cf78dd6011d670007419011c34))
+* initial project setup with plan for Wayback Machine MCP server ([f265ed8](https://github.com/Mearman/mcp-wayback-machine/commit/f265ed824184f009f1d39a6716632337ae1e58c3))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/LICENSE

@@ -0,0 +1,24 @@
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License
+
+MCP Wayback Machine Server
+Copyright (c) 2025
+
+This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
+
+You are free to:
+- Share — copy and redistribute the material in any medium or format
+- Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+- NonCommercial — You may not use the material for commercial purposes.
+- ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
+
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+
+Notices:
+You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.
+
+No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.
+
+For commercial use or licensing inquiries, please contact the copyright holder.

package/README.md

@@ -0,0 +1,194 @@
+# MCP Wayback Machine Server
+
+[![npm version](https://img.shields.io/npm/v/mcp-wayback-machine.svg)](https://www.npmjs.com/package/mcp-wayback-machine)
+[![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC-SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/Mearman/mcp-wayback-machine/ci.yml?branch=main)](https://github.com/Mearman/mcp-wayback-machine/actions)
+
+An MCP (Model Context Protocol) server and CLI tool for interacting with the Internet Archive's Wayback Machine. Supports full CDX search, snapshot content retrieval, screenshot listing, snapshot comparison, and optional authentication for higher rate limits.
+
+## Installation
+
+### As an MCP server
+
+Add to your MCP client configuration (Claude Desktop, VS Code, etc.):
+
+```json
+{
+  "mcpServers": {
+    "wayback-machine": {
+      "command": "npx",
+      "args": ["-y", "mcp-wayback-machine"],
+      "env": {
+        "WAYBACK_ACCESS_KEY": "your-access-key",
+        "WAYBACK_SECRET_KEY": "your-secret-key"
+      }
+    }
+  }
+}
+```
+
+The `env` block is optional — the server works anonymously without credentials. See [Credentials](#credentials) for details.
+
+### As a CLI tool
+
+```bash
+npx mcp-wayback-machine save https://example.com
+```
+
+Or install globally:
+
+```bash
+npm install -g mcp-wayback-machine
+wayback save https://example.com
+```
+
+## Tools
+
+### `save_url`
+
+Archive a URL to the Wayback Machine using the SPN2 API.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL to archive |
+| `captureScreenshot` | No | Capture a screenshot as a PNG image |
+| `captureOutlinks` | No | Also archive up to 100 outlinked pages |
+| `ifNotArchivedWithin` | No | Skip if archived within timeframe, e.g. `"30d"` |
+| `jsBehaviorTimeout` | No | Run JavaScript for N seconds before capturing (max 30) |
+| `forceGet` | No | Use simple HTTP GET instead of browser rendering |
+| `delayWbAvailability` | No | Delay indexing ~12 hours to reduce server load |
+
+### `get_archived_url`
+
+Retrieve an archived snapshot's content and metadata.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL to retrieve |
+| `timestamp` | No | Specific timestamp (`YYYYMMDDhhmmss`) or `"latest"` |
+| `modifier` | No | URL modifier: `id_` (raw), `im_` (screenshot), `js_` (JS), `cs_` (CSS) |
+
+Returns the snapshot's HTML/content body, content type, archived URL, and timestamp.
+
+### `search_archives`
+
+Search the CDX API for archived versions of a URL.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL pattern to search for |
+| `matchType` | No | `exact`, `prefix`, `host`, or `domain` |
+| `from` | No | Start date (`YYYYMMDD` or `YYYY-MM-DD`) |
+| `to` | No | End date (`YYYYMMDD` or `YYYY-MM-DD`) |
+| `limit` | No | Maximum results (default 10) |
+| `offset` | No | Skip the first N results |
+| `collapse` | No | Collapse duplicates, e.g. `"timestamp:8"` (per hour), `"digest"` |
+| `filter` | No | Filter by field regex, e.g. `["statuscode:200", "!mimetype:image.*"]` |
+| `resolveRevisits` | No | Resolve warc/revisit entries to original metadata |
+| `showDupeCount` | No | Show duplicate count per capture |
+| `page` | No | Page number for pagination |
+| `pageSize` | No | Results per page |
+
+### `check_archive_status`
+
+Check archival statistics for a URL — capture counts, yearly breakdowns, and first/last capture dates.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL to check |
+
+### `list_screenshots`
+
+List available screenshots for a URL. Screenshots are generated when captures are made with `captureScreenshot: true`.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL to find screenshots for |
+| `limit` | No | Maximum results (default 10) |
+
+### `compare_snapshots`
+
+Compare two archived snapshots of a URL. Fetches the raw content of both and provides a visual diff URL.
+
+| Parameter | Required | Description |
+|---|---|---|
+| `url` | Yes | The URL to compare snapshots for |
+| `timestampA` | No | First timestamp. Defaults to oldest available. |
+| `timestampB` | No | Second timestamp. Defaults to newest available. |
+
+If no timestamps are provided, automatically selects the oldest and newest available snapshots.
+
+### `clear_cache`
+
+Clear all cached API responses. Use when fresh data is needed or after saving a new URL.
+
+## CLI Usage
+
+```bash
+# Archive a URL
+wayback save https://example.com
+
+# Retrieve archived content
+wayback get https://example.com
+wayback get https://example.com --timestamp 20231225120000
+
+# Search archived versions
+wayback search https://example.com --from 2023-01-01 --to 2023-12-31
+wayback search https://example.com --limit 20
+
+# Check archival statistics
+wayback status https://example.com
+
+# List screenshots
+wayback screenshots https://example.com
+
+# Compare two snapshots
+wayback compare https://example.com
+wayback compare https://example.com --timestamp-a 20230101000000 --timestamp-b 20240101000000
+```
+
+## Credentials
+
+The server works anonymously by default. For higher SPN2 rate limits, set Internet Archive S3 credentials via environment variables:
+
+```bash
+export WAYBACK_ACCESS_KEY="your-access-key"
+export WAYBACK_SECRET_KEY="your-secret-key"
+```
+
+Credentials are only sent on `/save` endpoints. All read operations (retrieve, search, status, screenshots, compare) work without authentication.
+
+To obtain credentials, log in to [archive.org](https://archive.org) and visit your account settings to generate S3 access keys.
+
+## Technical Details
+
+- **Transport**: stdio (MCP client integration)
+- **Caching**: in-memory and disk-based with per-endpoint TTLs:
+  - Snapshot content: 24 hours (immutable once captured)
+  - Availability, CDX, sparkline: 1 hour (grows but never mutates)
+  - Save operations: 30 minutes (idempotent per URL)
+  - Save status polling: 30 seconds (changes during active jobs)
+- **Rate limiting**: 15 requests per minute, with automatic Retry-After handling for 429 responses
+- **Validation**: Zod schemas for all inputs and API responses
+- **Node.js 22+** required
+
+## Development
+
+Requires [pnpm](https://pnpm.io) and Node.js 22+.
+
+```bash
+pnpm install
+pnpm validate     # typecheck + lint + test + build
+```
+
+## Resources
+
+- [Wayback Machine APIs](https://archive.org/developers/wayback-api.html)
+- [CDX Server Documentation](https://github.com/internetarchive/wayback/tree/master/wayback-cdx-server)
+- [Save Page Now 2 (SPN2) API](https://docs.google.com/document/d/1Nsv52MvSjbLb2PCpHlat0gkzw0EvtSgpKHu4mk0MnrA/)
+
+## License
+
+[Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International](http://creativecommons.org/licenses/by-nc-sa/4.0/).
+
+[![CC BY-NC-SA 4.0](https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-sa/4.0/)

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { GetArchivedUrl, getArchivedUrl } from "./tools/retrieve.js";
+import { SaveUrl, saveUrl } from "./tools/save.js";
+import { SearchArchives, searchArchives } from "./tools/search.js";
+import { CheckArchiveStatus, checkArchiveStatus } from "./tools/status.js";
+import { ListScreenshots, listScreenshots } from "./tools/screenshots.js";
+import { ClearCache, clearCache } from "./tools/cache.js";
+import { CompareSnapshots, compareSnapshots } from "./tools/compare.js";
+import { context } from "./contexts.js";
+import pkg from "../package.json" with { type: "json" };
+const VERSION = pkg.version;
+const server = new McpServer({
+    name: "mcp-wayback-machine",
+    version: VERSION,
+}, {
+    capabilities: {
+        tools: {},
+    },
+    instructions: "Interact with the Internet Archive's Wayback Machine to save, retrieve, search, and check the archival status of URLs. " +
+        "Supports screenshot retrieval, full CDX search with filtering/pagination, " +
+        "and optional authentication for higher rate limits.",
+});
+server.registerTool("save_url", {
+    description: "Save a URL to the Wayback Machine for archival using the SPN2 API. " +
+        "Supports capturing screenshots, outlinks, and conditional archiving. " +
+        "Set WAYBACK_ACCESS_KEY and WAYBACK_SECRET_KEY env vars for higher rate limits.",
+    inputSchema: SaveUrl,
+}, async (args) => {
+    const result = await saveUrl(args, context);
+    let text = result.message;
+    if (result.archivedUrl !== undefined) {
+        text += `\n\nArchived URL: ${result.archivedUrl}`;
+    }
+    if (result.timestamp !== undefined) {
+        text += `\nTimestamp: ${result.timestamp}`;
+    }
+    if (result.jobId !== undefined) {
+        text += `\nJob ID: ${result.jobId}`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("get_archived_url", {
+    description: "Retrieve an archived version of a URL from the Wayback Machine. " +
+        "Returns the snapshot content. Supports URL modifiers: " +
+        "id_ (raw content), im_ (screenshot image), js_ (JavaScript), cs_ (CSS).",
+    inputSchema: GetArchivedUrl,
+}, async (args) => {
+    const result = await getArchivedUrl(args, context);
+    let text = result.message;
+    if (result.archivedUrl !== undefined) {
+        text += `\n\nArchived URL: ${result.archivedUrl}`;
+    }
+    if (result.timestamp !== undefined) {
+        text += `\nTimestamp: ${result.timestamp}`;
+    }
+    if (result.available !== undefined) {
+        text += `\nAvailable: ${result.available ? "Yes" : "No"}`;
+    }
+    if (result.content !== undefined) {
+        text += `\n\nContent-Type: ${result.contentType ?? "unknown"}`;
+        text += `\n\n${result.content}`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("search_archives", {
+    description: "Search the Wayback Machine CDX API for archived versions of a URL. " +
+        "Supports match types (exact/prefix/host/domain), date range filtering, " +
+        "collapsing duplicates, field filtering, pagination, and duplicate counting.",
+    inputSchema: SearchArchives,
+}, async (args) => {
+    const result = await searchArchives(args, context);
+    let text = result.message;
+    if (result.results !== undefined && result.results.length > 0) {
+        text += "\n\nResults:";
+        for (const archive of result.results) {
+            text += `\n\n- Date: ${archive.date}`;
+            text += `\n  URL: ${archive.archivedUrl}`;
+            text += `\n  Status: ${archive.statusCode}`;
+            text += `\n  Type: ${archive.mimeType}`;
+            if (archive.duplicateCount !== undefined) {
+                text += `\n  Duplicates: ${String(archive.duplicateCount)}`;
+            }
+        }
+    }
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("check_archive_status", {
+    description: "Check if a URL has been archived by the Wayback Machine and get capture " +
+        "statistics including yearly breakdowns.",
+    inputSchema: CheckArchiveStatus,
+}, async (args) => {
+    const result = await checkArchiveStatus(args, context);
+    let text = result.message;
+    if (result.isArchived) {
+        if (result.firstCapture !== undefined) {
+            text += `\n\nFirst captured: ${result.firstCapture}`;
+        }
+        if (result.lastCapture !== undefined) {
+            text += `\nLast captured: ${result.lastCapture}`;
+        }
+        if (result.totalCaptures !== undefined) {
+            text += `\nTotal captures: ${String(result.totalCaptures)}`;
+        }
+        if (result.yearlyCaptures !== undefined &&
+            Object.keys(result.yearlyCaptures).length > 0) {
+            text += "\n\nCaptures by year:";
+            for (const [year, count] of Object.entries(result.yearlyCaptures)) {
+                text += `\n  ${year}: ${String(count)}`;
+            }
+        }
+    }
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("list_screenshots", {
+    description: "List available screenshots for a URL from the Wayback Machine. " +
+        "Screenshots are generated when captures are made with capture_screenshot=1.",
+    inputSchema: ListScreenshots,
+}, async (args) => {
+    const result = await listScreenshots(args, context);
+    let text = result.message;
+    if (result.screenshots !== undefined && result.screenshots.length > 0) {
+        text += "\n\nScreenshots:";
+        for (const screenshot of result.screenshots) {
+            text += `\n\n- Date: ${screenshot.date}`;
+            text += `\n  Screenshot: ${screenshot.screenshotUrl}`;
+            text += `\n  Original: ${screenshot.originalUrl}`;
+        }
+    }
+    return { content: [{ type: "text", text }] };
+});
+server.registerTool("clear_cache", {
+    description: "Clear all cached Wayback Machine API responses. " +
+        "Use when fresh data is needed or after saving a URL.",
+    inputSchema: ClearCache,
+}, async () => {
+    const result = await clearCache();
+    return { content: [{ type: "text", text: result.message }] };
+});
+server.registerTool("compare_snapshots", {
+    description: "Compare two archived snapshots of a URL. " +
+        "Fetches the raw content of both snapshots and provides a visual diff URL. " +
+        "If no timestamps specified, compares the oldest and newest available snapshots.",
+    inputSchema: CompareSnapshots,
+}, async (args) => {
+    const result = await compareSnapshots(args, context);
+    let text = result.message;
+    if (result.snapshotA !== undefined && result.snapshotB !== undefined) {
+        text += `\n\nSnapshot A: ${result.snapshotA.date} (${result.snapshotA.timestamp})`;
+        text += `\nSnapshot B: ${result.snapshotB.date} (${result.snapshotB.timestamp})`;
+    }
+    if (result.changesUrl !== undefined) {
+        text += `\n\nVisual diff: ${result.changesUrl}`;
+    }
+    if (result.contentA !== undefined) {
+        text += `\n\n--- Snapshot A Content ---\n${result.contentA}`;
+    }
+    if (result.contentB !== undefined) {
+        text += `\n\n--- Snapshot B Content ---\n${result.contentB}`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+async function main() {
+    const isCliMode = process.stdin.isTTY || process.argv.length > 2;
+    if (isCliMode && process.argv.length > 2) {
+        const { createCLI } = await import("./cli.js");
+        const program = createCLI();
+        await program.parseAsync(process.argv);
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("MCP Wayback Machine server running on stdio");
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AAE5B,MAAM,MAAM,GAAG,IAAI,SAAS,CACxB;IACI,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACnB,EACD;IACI,YAAY,EAAE;QACV,KAAK,EAAE,EAAE;KACZ;IACD,YAAY,EACR,yHAAyH;QACzH,4EAA4E;QAC5E,qDAAqD;CAC5D,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,UAAU,EACV;IACI,WAAW,EACP,qEAAqE;QACrE,uEAAuE;QACvE,gFAAgF;IACpF,WAAW,EAAE,OAAO;CACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE5C,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,IAAI,qBAAqB,MAAM,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,aAAa,MAAM,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,kBAAkB,EAClB;IACI,WAAW,EACP,kEAAkE;QAClE,wDAAwD;QACxD,yEAAyE;IAC7E,WAAW,EAAE,cAAc;CAC9B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnD,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,IAAI,qBAAqB,MAAM,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,gBAAgB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,IAAI,qBAAqB,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC;QAC/D,IAAI,IAAI,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,iBAAiB,EACjB;IACI,WAAW,EACP,qEAAqE;QACrE,yEAAyE;QACzE,6EAA6E;IACjF,WAAW,EAAE,cAAc;CAC9B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnD,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,IAAI,IAAI,cAAc,CAAC;QACvB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,IAAI,eAAe,OAAO,CAAC,IAAI,EAAE,CAAC;YACtC,IAAI,IAAI,YAAY,OAAO,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,IAAI,eAAe,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,IAAI,aAAa,OAAO,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,IAAI,mBAAmB,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,sBAAsB,EACtB;IACI,WAAW,EACP,0EAA0E;QAC1E,yCAAyC;IAC7C,WAAW,EAAE,kBAAkB;CAClC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvD,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,IAAI,uBAAuB,MAAM,CAAC,YAAY,EAAE,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,IAAI,oBAAoB,MAAM,CAAC,WAAW,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,IAAI,qBAAqB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,IACI,MAAM,CAAC,cAAc,KAAK,SAAS;YACnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAC/C,CAAC;YACC,IAAI,IAAI,uBAAuB,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CACtC,MAAM,CAAC,cAAc,CACxB,EAAE,CAAC;gBACA,IAAI,IAAI,OAAO,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,kBAAkB,EAClB;IACI,WAAW,EACP,iEAAiE;QACjE,6EAA6E;IACjF,WAAW,EAAE,eAAe;CAC/B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpD,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,IAAI,IAAI,kBAAkB,CAAC;QAC3B,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,IAAI,eAAe,UAAU,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,IAAI,mBAAmB,UAAU,CAAC,aAAa,EAAE,CAAC;YACtD,IAAI,IAAI,iBAAiB,UAAU,CAAC,WAAW,EAAE,CAAC;QACtD,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,aAAa,EACb;IACI,WAAW,EACP,kDAAkD;QAClD,sDAAsD;IAC1D,WAAW,EAAE,UAAU;CAC1B,EACD,KAAK,IAAI,EAAE;IACP,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,mBAAmB,EACnB;IACI,WAAW,EACP,2CAA2C;QAC3C,4EAA4E;QAC5E,iFAAiF;IACrF,WAAW,EAAE,gBAAgB;CAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAErD,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnE,IAAI,IAAI,mBAAmB,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC;QACnF,IAAI,IAAI,iBAAiB,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,IAAI,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,IAAI,mCAAmC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,IAAI,mCAAmC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC,CACJ,CAAC;AAEF,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjE,IAAI,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACJ,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function createCLI(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,SAAS,YA4OxB"}