How to Use the Library of Congress MCP in OpenAI Agents SDK
Get raw historical data directly into your OpenAI Agents SDK pipelines with zero manual configuration using this dedicated MCP Server.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Library of Congress MCP to OpenAI Agents SDK
Create your Vinkius account to connect Library of Congress 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.
Run targeted historical queries with OpenAI Agents SDK.
The `search` tool executes direct keyword queries against the entire Library of Congress database, passing raw strings straight from your OpenAI Agents SDK loop. You get raw historical records without dealing with manual scraping scripts in your OpenAI Agents SDK workspace. To narrow down the noise, your OpenAI Agents SDK agent uses `search_format` to filter Library of Congress results by maps, photos, or audio. This keeps your OpenAI Agents SDK context window focused strictly on high-value Library of Congress resources.
Extract raw text data using this MCP Server.
The `get_item` tool fetches detailed bibliographic data for any specific asset your OpenAI Agents SDK agent discovers during its Library of Congress search phase. This metadata allows the OpenAI Agents SDK workflow to inspect the exact provenance of old Library of Congress records. For printed Library of Congress materials, your OpenAI Agents SDK workflow calls `get_text_service` to pull full-text OCR, word coordinates, and context snippets. Your OpenAI Agents SDK agent reads these Library of Congress text snippets directly to answer historical questions without downloading huge image files.
Inspect visual assets directly in your agentic workflows.
The `get_image_info` tool retrieves technical IIIF metadata for specific Library of Congress images, giving your OpenAI Agents SDK agent the exact dimensions and tiling details it needs. This avoids blind processing errors when your OpenAI Agents SDK agent handles high-resolution Library of Congress maps. Combine this with `get_resource` so your OpenAI Agents SDK agent can pull discrete digitized files like individual Library of Congress newspaper pages using a specific resource identifier. Your OpenAI Agents SDK agent handles these Library of Congress file endpoints directly, keeping your processing pipeline clean.
Set up Library of Congress MCP in OpenAI Agents SDK
Prerequisites
- Python 3.10+ installed
-
openai-agentspackage (pip install openai-agents) - Active Vinkius subscription with a valid endpoint token
- 1
Install the SDK
Run
pip install openai-agentsto install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed. - 2
Connect via SSE transport
Use
MCPServerSsewith your Vinkius endpoint URL. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. The SDK auto-discovers all Library of Congress tools at runtime. - 3
Create your Agent
Pass the MCP to
Agent(mcp_servers=[server]). The agent receives Library of Congress tools as native definitions — JSON schemas resolve automatically. - 4
Run the agent
Call
Runner.run(agent, prompt)to execute. The agent invokes the appropriate Library of Congress tools and returns structured results. Copy the full example on the right to get started.
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="Library of Congress Agent",
instructions="You have access to Library of Congress tools.",
mcp_servers=[server],
)
result = await Runner.run(agent, "List recent transactions")
print(result.final_output)
asyncio.run(main())Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Library of Congress. 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.
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 Library of Congress MCP in OpenAI Agents SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Library of Congress MCP today
We host it, we monitor it, we maintain it. You just paste one token.
