How to Use the Internet Archive MCP in Vercel AI SDK

Q: How do I perform a specific Internet Archive search within my Vercel AI SDK project?

You pass the query string directly to the search tool through your agent's tool-calling loop. The Vercel AI SDK handles the stream, and the results appear in your UI as they arrive.

Q: Can I use the Internet Archive tools to show file availability in my Vercel AI SDK dashboard?

Yes. Call getitemmetadata using the item identifier to receive a full list of available file formats. You can then map these to download buttons in your interface.

Q: Does the Vercel AI SDK support real-time Wayback Machine lookups using this MCP Server?

It does. The waybackavailability tool returns a JSON response containing the snapshot URL, which you can inject into an iframe or link tag in your frontend.

Q: How do I handle pagination for search results?

Use the page and rows parameters in the search tool. You can adjust the row count up to 100 per request to manage how much data your client displays.

Stream Internet Archive history directly into your Vercel AI SDK interface for real-time data discovery.

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 Vercel AI SDK

Create your Vinkius account to connect Internet Archive to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search and filter historical media

Pipe live search results into your React components using the `search` and `search_by_mediatype` tools. Your users get immediate access to over 40 million items without waiting for bulky backend processing. This MCP Server handles the query logic while your frontend renders the metadata. Use `search_by_collection` to narrow results to specific archives like the Prelinger films or Project Gutenberg ebooks.

Metadata and file retrieval

Fetch deep item details with `get_item_metadata` to populate your UI components instantly. You get titles, creators, and direct download links for various formats like PDF or MP4. Combine this with `get_item_files` to provide your end users with specific file lists. The data streams into your app as soon as the agent calls the tool.

Wayback Machine integration

Verify the existence of historical web snapshots using the `wayback_availability` tool. It returns the most recent timestamp so you can link directly to preserved pages. This keeps your application context current with the Internet Archive. It is a quick way to show users what a site looked like at a specific point in time.

Setup guide

Set up Internet Archive MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Internet Archive tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Internet Archive transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

You pass the query string directly to the `search` tool through your agent's tool-calling loop. The Vercel AI SDK handles the stream, and the results appear in your UI as they arrive.

Yes. Call `get_item_metadata` using the item identifier to receive a full list of available file formats. You can then map these to download buttons in your interface.

It does. The `wayback_availability` tool returns a JSON response containing the snapshot URL, which you can inject into an iframe or link tag in your frontend.

Use the page and rows parameters in the `search` tool. You can adjust the row count up to 100 per request to manage how much data your client displays.

This server only accesses public metadata and file pointers from the Internet Archive. No personal user data is sent to the archive, and all connections are handled through your specified endpoint.

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