v0.2.3 — multi-client install picker

uvx mcp-server-wayback --install now opens a numbered menu of supported MCP clients:

• Claude Desktop
• Claude Code (user-scope, ~/.claude.json)
• Claude Code (project-scope, ./.mcp.json)
• Cursor (project-scope, ./.cursor/mcp.json)
• Windsurf
• Zed (uses context_servers key)

Pass a client key explicitly for non-interactive use (e.g. --install claude-code-user). New --list-clients flag prints the registry. Same flag set works for --uninstall. No breaking changes — existing --install (no arg) still installs to Claude Desktop when stdin isn't a TTY.

v0.2.1 — fix prompt argument parsing

Fixes Pydantic int_parsing errors when slash-command clients pass free-text input to prompts.

research_topic and track_site_changes now take a single free-text argument each; the model interprets year ranges / date ranges from the phrasing.

Closes #20.

v0.1.0 — first PyPI release

First public release. mcp-server-wayback is now installable from PyPI and runs in any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Codex CLI, etc.) over stdio.

Install

{
  "mcpServers": {
    "wayback": {
      "command": "uvx",
      "args": ["mcp-server-wayback"]
    }
  }
}

Or pip install mcp-server-wayback for a global binary.

What's in the box

6 tools

• check_availability — closest snapshot lookup
• lookup_snapshots — CDX history with date / status filters
• search_archive — Lucene search across IA collections
• search_domain — discover archived URLs under a domain or path prefix
• get_snapshot_content — fetch archived page text
• get_item_metadata — rich IA item metadata

4 prompts

• research_topic, track_site_changes, audit_link_rot, setup_authentication

1 resource

• wayback://item/{identifier}

Notes

• Async token-bucket rate limiter with Retry-After honoring
• In-memory response cache with per-endpoint TTLs
• Optional Internet Archive S3 authentication for higher rate ceilings
• 107 unit tests + opt-in --integration suite against live IA APIs