How to Use the Internet Archive MCP in Windsurf

Q: Can Windsurf download book files from the Internet Archive?

Yes, it fetches file lists directly. Windsurf calls getitemfiles to find the exact PDF or EPUB formats available for an item. From there, it can write a script or use your terminal to download them.

Q: Does this Internet Archive MCP server let Windsurf fix broken links?

Yes, it checks the Wayback Machine. Windsurf calls waybackavailability to find archived snapshots of dead URLs. It then automatically patches those broken links in your workspace files.

Let Windsurf autonomously dig up historical data, check Wayback machine links, and pull files from the Internet Archive.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Internet Archive MCP to Windsurf

Create your Vinkius account to connect Internet Archive to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Internet Archive with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously track down historical sources

Cascade can chain multi-step research tasks without waiting for you. When you ask Windsurf to find a specific text, this MCP server runs `search` to locate the identifier, immediately followed by `get_item_metadata` to verify the publishing details. If the agent finds what you need, it pulls the exact download links using `get_item_files`. You get the actual historical documents delivered straight to your workspace without having to click through the web UI.

Verify dead links with this Windsurf MCP Server

Broken links kill reference sections in your markdown files. Windsurf uses `wayback_availability` to check if a dead URL has a saved snapshot on the Wayback Machine. The agent reads the returned timestamp and rewrites your broken markdown links to point directly to the archived version. It does this across your entire workspace in one go.

Sift through massive media collections

Finding specific historical audio or video files usually takes forever. Windsurf handles this by targeting specific datasets using `search_by_collection` and `search_by_mediatype` in a single MCP execution loop. The agent filters out noise by creator using `search_by_creator` and narrows the dates down with `search_by_date_range`. You get a clean list of primary sources matching your exact historical window.

Setup guide

Set up Internet Archive MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Internet Archive MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Internet Archive payment history." If connected, Cascade will call the Internet Archive tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "internet-archive-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Internet Archive. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Internet Archive now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Internet Archive MCP in Windsurf

Cascade chains search tools automatically. You give it a topic, and it runs `search` before drilling down with `get_item_metadata` to grab the best files. It does not stop to ask for your permission at every step.

Yes, it fetches file lists directly. Windsurf calls `get_item_files` to find the exact PDF or EPUB formats available for an item. From there, it can write a script or use your terminal to download them.

Yes, it checks the Wayback Machine. Windsurf calls `wayback_availability` to find archived snapshots of dead URLs. It then automatically patches those broken links in your workspace files.

Yes, the server exposes dedicated filters. You can instruct Cascade to use `search_by_mediatype` to isolate software, audio, or video. This prevents text documents from cluttering your workspace results.

Your search terms and URL lookups go straight to archive.org via a secure V8 sandbox. Vinkius runs this in an ephemeral environment, meaning no search history or target URLs are stored on our servers. Everything wipes clean the moment your session ends.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript