How to Use the Internet Archive Metadata MCP in OpenAI Agents SDK

Integrate Internet Archive Metadata directly into your OpenAI Agents SDK production pipeline for reliable, verified data retrieval.

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 Metadata MCP to OpenAI Agents SDK

Create your Vinkius account to connect Internet Archive Metadata to OpenAI Agents 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 Metadata with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Structured metadata extraction for agents

Your agent pulls precise item details using `get_metadata` to feed into your reasoning engine. It handles title, creator, and date fields without manual parsing. This MCP Server ensures your agent gets clean JSON responses. By setting cacheToolsList=True, you keep the agent fast during high-volume production tasks.

Download source files via agent logic

Your agent identifies specific media formats using `get_files` to locate direct download links. It bypasses the need for manual navigation of the archive site. Once the file list is retrieved, your agent can trigger downstream processing tasks. This removes the friction of finding the correct URL for archived content.

Analyze community feedback and item stats

Your agent queries `get_reviews` to weigh community sentiment before deciding to process an item. It builds a data-driven filter for your content curation workflows. Using `get_stats` lets your agent identify high-traffic resources within the archive. You prioritize popular or reliable assets based on real-time activity metrics.

Setup guide

Set up Internet Archive Metadata MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Internet Archive Metadata tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Internet Archive Metadata tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Internet Archive Metadata tools and returns structured results. Copy the full example on the right to get started.

agent.py

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

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Internet Archive Metadata Agent",
            instructions="You have access to Internet Archive Metadata tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Metadata. 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 Metadata 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 Metadata MCP in OpenAI Agents SDK

Initialize your agent with the MCP Server endpoint using the MCPServerStreamableHttp class. Once connected, your agent automatically discovers and calls tools like `get_metadata` to ingest data.

Yes. The SDK manages these payloads effectively by processing them as structured objects. If you only need basic info, use `get_metadata_only` to keep your context window lean.

The server only provides public read access to archive records. Your agent interacts with this data using your defined guardrails, ensuring no sensitive credentials are ever transmitted.

The OpenAI Agents SDK provides full tracing, so you can inspect the failure in your dashboard. You should implement basic error handling in your agent logic to retry if a timeout occurs.

You are subject to standard public API rate limits. Monitor your agent's request frequency to ensure you stay within the bounds of the Internet Archive's public service policies.

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