How do I get the identifier for an item?

The identifier is the unique string in the item's URL. For example, from https://archive.org/details/big_buck_bunny, the identifier is "big_buck_bunny". You can also get identifiers from search results using the ia-search-mcp server.

What file formats are typically available?

It depends on the item type. Texts often have PDF, EPUB, MOBI, plain text, and Daisy formats. Movies have MP4, OGV, and archival formats. Audio has MP3, OGG, and FLAC. The get_files tool shows all available formats for each item.

Can I see who reviewed an item?

Yes! Use the get_reviews tool. It returns the reviewer's username, star rating (1-5), review text, and review date. Not all items have reviews — community-contributed items tend to have more user feedback.

Internet Archive Metadata MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: Internet Archive Metadata
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Internet Archive Metadata through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Internet Archive Metadata Assistant",
            instructions=(
                "You help users interact with Internet Archive Metadata. "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Internet Archive Metadata"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Internet Archive Metadata MCP Server

Connect Internet Archive Metadata to any AI agent and retrieve comprehensive details about any archived item — including file listings, user reviews, collection memberships, access statistics, and modification history.

The OpenAI Agents SDK auto-discovers all 10 tools from Internet Archive Metadata through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Internet Archive Metadata, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Complete Metadata — Title, creator, date, description, subjects, license, language
File Listings — All downloadable files with formats (PDF, EPUB, MP4, MP3) and sizes
User Reviews — Community ratings and review text
Collection Info — Which collections the item belongs to
View Statistics — Download and view counts
Modification History — Track changes made to items over time
Parent Collections — Hierarchical categorization structure
Derivative Files — Auto-generated thumbnails, streaming files, OCR text
Lightweight Lookup — Metadata-only mode for fast queries
Server Info — Storage location and hosting details

The Internet Archive Metadata MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Internet Archive Metadata to OpenAI Agents SDK via MCP

Follow these steps to integrate the Internet Archive Metadata MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from Internet Archive Metadata

Why Use OpenAI Agents SDK with the Internet Archive Metadata MCP Server

OpenAI Agents SDK provides unique advantages when paired with Internet Archive Metadata through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Internet Archive Metadata + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Internet Archive Metadata MCP Server delivers measurable value.

Automated workflows: build agents that query Internet Archive Metadata, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries Internet Archive Metadata, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Internet Archive Metadata tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Internet Archive Metadata to resolve tickets, look up records, and update statuses without human intervention

Internet Archive Metadata MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect Internet Archive Metadata to OpenAI Agents SDK via MCP:

get_collections

Items can belong to multiple collections (e.g., "prelinger", "opensource_movies"). Use this to understand the categorization of an item. Get collections an item belongs to

get_derivatives

). These are derived from the original uploads. Use this to see what processed formats are available. Get auto-generated derivative files for an item

get_files

Files can be downloaded from: https://archive.org/download/{identifier}/{filename}. Use this to see what formats are available. Get all downloadable files for an Internet Archive item

get_history

Use this to track changes to an item over time. Get modification history of an Internet Archive item

get_metadata

Returns title, creator, date, description, subjects, collection, files, reviews, and stats. The identifier is found in item URLs (e.g., from archive.org/details/big_buck_bunny, identifier is "big_buck_bunny"). Use this for comprehensive item information. Get complete metadata for an Internet Archive item

get_metadata_only

Lighter response for quick lookups. Use this when you only need basic item information. Get only the metadata fields without files or reviews

get_parents

Use this to understand the broader categorization structure. Get parent collections of an Internet Archive item

get_reviews

Returns reviewer names, star ratings, and review text. Not all items have reviews. Use this to see community feedback. Get user reviews for an Internet Archive item

get_server_info

Useful for understanding where files are hosted. Use this for technical diagnostics. Get server and storage information for an item

get_stats

Shows how popular the item is. Use this to measure item popularity. Get access statistics for an Internet Archive item

Example Prompts for Internet Archive Metadata in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Internet Archive Metadata immediately.

"Get metadata for item big_buck_bunny."

"List all files for item gutenberg_etext1."

"Get reviews for item nasa_apollo11."

Troubleshooting Internet Archive Metadata MCP Server with OpenAI Agents SDK

Common issues when connecting Internet Archive Metadata to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Internet Archive Metadata + OpenAI Agents SDK FAQ

Common questions about integrating Internet Archive Metadata MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.