How to integrate Archive.org MCP with Atomic Agent

Connect Atomic Agent to Archive.org MCP. Find wayback snapshots for example.com, download all files for item abc123, and more using natural language, with authentication handled for you.

Archive.org logoArchive.org
Api Key

Archive.org is the Internet Archive's digital library of websites, books, audio, video, and images. Use it to preserve, explore, and access historical web captures and public-domain media.

26 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Archive.org.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Archive.org account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Archive.org with

How Atomic Agent connects to Archive.org

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Archive.org to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Archive.org. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Archive.org account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Archive.org MCP server, and what's possible with it?

The Archive.org MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Archive.org account. It provides structured and secure access to archived content, Wayback captures, item records, usage analytics, and account tasks, so your agent can search collections, retrieve files, manage items, inspect activity, and handle reviews on your behalf.

  • Content search and retrieval: Have your agent search Archive.org by keywords and metadata, inspect complete item records, and download public files.
  • Wayback history research: Instruct your agent to find the closest archived version of a web page or list available captures for a website.
  • Item and file management: Direct your agent to check identifier availability, upload, copy, or delete files, update item metadata, and request new derivatives.
  • Images, manifests, and analytics: Let the agent inspect IIIF image details and manifests, render selected image regions, and review item views, history, geography, and referrers.
  • Account tasks and reviews: Have your agent check your account details, monitor catalog tasks and limits, read task logs, and create, update, retrieve, or delete your reviews.

Use Archive.org from Atomic Agent

With your account connected, ask Atomic Agent to work with Archive.org in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Archive.org action and event your agent gets out of the box.

Advanced Search Archive.org Items

Search Archive.org metadata with exact Advanced Search page semantics.

Check Identifier Availability

Check whether an Archive.org item identifier is available before attempting to create an item.

Check Archive.org Upload Limit

Check whether Archive.org's ingest queue is likely to accept an upload or delete, using only the connection's LOW Authorization header.

Copy Item File

Copy one Archive.org file server-side to a named path in an existing destination item.

Delete Item File

Submit asynchronous deletion of one named file from an Archive.org item through IA-S3.

Delete My Archive.org Review

Permanently delete the connected Archive.org user's public review from one item.

Derive Archive.org Item

Queue Archive.org's fixed derive.php task for an item owned or editable by the connected account.

Download Item File

Download a public Archive.org item file or a bounded byte range and return a temporary downloadable file reference.

Find Wayback Snapshots

Find the closest archived Wayback Machine snapshot for each requested URL, using one before, after, or either direction for the batch.

Get Connected Archive.org User

Return the authenticated Archive.org user's identity and privileges without returning either IA-S3 credential.

Get Detailed Archive.org Views

Get bounded geographic view analytics and, for items, top referrers over a recent window or date range.

Get IIIF Image Info

Get normalized IIIF Image API capabilities through Archive.org's fixed-host single-image convenience route or a live-proven versioned file route.

Get IIIF Manifest

Get a compact IIIF Presentation manifest for an Archive.org item or one page of an Archive.org collection.

Get Item Metadata

Get a compact Archive.org item record including metadata, file inventory, public reviews and catalog tasks, or return one selected metadata field or array slice.

Get Item View Counts

Get all-time, last-30-day, and last-7-day view counts for one or more Archive.org item or collection identifiers from the current or legacy counting pipeline.

Get Item View History

Get a bounded daily view history for one Archive.org item or collection, split by robot classification.

Get My Review

Get the connected Archive.org user's review for one item, if that user has reviewed it.

Get Archive.org Task Log

Download a plain-text log for a task visible to the connected account.

Get Task Rate Limits

Report the connected account's current task capacity and in-flight counts for one Archive.org catalog command.

List Archive.org Tasks

Return any documented combination of the connected account's task summary, active catalog, and resource-authorized history, one page at a time.

List Wayback Captures

Return one bounded structured CDX page of Wayback captures for a URL or host.

Render IIIF Image

Render a bounded crop, resize, rotation, quality, and format from a fixed Archive.org IIIF image route.

Search Archive.org Items

Search Archive.org item metadata with a Lucene-style query and return one cursor-paginated page of matching items, or request only the match count.

Update Item Metadata

Queue JSON Patch changes to an editable Archive.org item's ordinary metadata or named file metadata records.

Upload Item File

Create or replace one file through Archive.org IA-S3, explicitly choosing a new-item or existing-item upload.

Upsert My Archive.org Review

Queue creation or replacement of the connected Archive.org user's public review for an eligible item.

FAQ

Frequently asked questions

Start with Archive.org.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Archive.org tool your agent needs.Free to start.

Start building