Metadata-Version: 2.5
Name: archive-org-mcp
Version: 0.1.0
Summary: MCP server for archive.org — Wayback Machine, Internet Archive catalog, and saved-page retrieval
Project-URL: Homepage, https://github.com/lesleslie/archive-org-mcp
Project-URL: Repository, https://github.com/lesleslie/archive-org-mcp
Author-email: Les Leslie <les@wedgwoodwebworks.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Requires-Dist: fastmcp>=2.12.0
Requires-Dist: httpx2>=0.28.1
Requires-Dist: mcp-common>=0.18.0
Requires-Dist: oneiric>=0.16.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Provides-Extra: dev
Requires-Dist: bandit>=1.7.9; extra == 'dev'
Requires-Dist: mypy>=1.9.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.8; extra == 'dev'
Description-Content-Type: text/markdown

# archive-org-mcp

> **Scaffold status: PyPI name reservation.** This package is a placeholder scaffold to claim
> the `archive-org-mcp` name on PyPI. The MCP server is not yet implemented.

MCP server for the [Internet Archive](https://archive.org) (archive.org).
Provides access to:

- **Wayback Machine** — query historical snapshots of any URL via the CDX API
- **Catalog search** — search the Internet Archive's metadata catalog (books,
  videos, audio, software, web pages)
- **Saved pages** — fetch archived page content for a specific timestamp
- **Availability** — closest-snapshot lookup for a URL + timestamp

## Reserve the PyPI name

```bash
cd /Users/les/Projects/archive-org-mcp
uv build
uv publish  # uses UV_PUBLISH_TOKEN from env
```

The package name `archive-org-mcp` is currently free on PyPI (verified 2026-08-31).
Publishing a placeholder 0.1.0 release locks the name.

## Architecture (planned)

Mirrors the `raindropio-mcp` pattern in this ecosystem:

- `httpx2` for the archive.org REST API client (no auth required for read-only
  endpoints; rate-limited)
- `fastmcp` for the MCP server surface
- `oneiric` for layered config (`settings/archive-org-mcp.yaml`, `local.yaml`,
  env vars) — configures the CDX endpoint, rate-limit backoff, and an
  optional `ARCHIVE_ORG_AUTH_TOKEN` for write- operations
- `mcp-common` for bootstrap, health endpoints
- `pydantic`/`pydantic-settings` for typed config models

## Why this name

We considered `internetarchive-mcp`, `waybackmachine-mcp`, `wayback-mcp` (taken),
and `ia-mcp` (collides with anything). `archive-org-mcp` is the user-facing
branding of the Internet Archive (their primary domain) and is the most
discoverable name.

## Status

| Phase | State |
|---|---|
| PyPI name reservation | **pending** (run `uv publish`) |
| Spec / plan | not written |
| Implementation | not started |
| Tests | not started |

## License

BSD-3-Clause.