National Archives Catalog MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 40 tools to Create Comment, Create Tag, Create Transcription, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect National Archives Catalog through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The National Archives Catalog MCP Server for OpenAI Agents SDK is a standout in the Knowledge Management category — giving your AI agent 40 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
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="National Archives Catalog Assistant",
instructions=(
"You help users interact with National Archives Catalog. "
"You have access to 40 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from National Archives Catalog"
)
print(result.final_output)
asyncio.run(main())
* 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 National Archives Catalog MCP Server
Connect to the National Archives Catalog (NARA) and explore the history of the United States through natural conversation. This MCP server allows your AI agent to act as a specialized research assistant, retrieving historical data, metadata, and digital objects from one of the world's largest archival collections.
The OpenAI Agents SDK auto-discovers all 40 tools from National Archives Catalog through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries National Archives Catalog, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Deep Search — Query records by text, tags, comments, or transcriptions to find specific historical context and documents.
- Record Hierarchy — Navigate complex archival structures by retrieving immediate children of specific parent records (NaId).
- User Contributions — Manage and search through tags, comments, and transcriptions provided by the citizen archivist community.
- Metadata Retrieval — Get detailed information, status metrics, and descriptions for specific National Archives Identifiers.
- Tagging & Interaction — Create or delete tags and comments to organize research findings directly within the catalog ecosystem.
The National Archives Catalog MCP Server exposes 40 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 40 National Archives Catalog tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to National Archives Catalog through Vinkius, your AI agent gets direct access to every tool listed below — spanning historical-records, nara, archives, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create comment on National Archives Catalog
Add a new comment to a record
Create tag on National Archives Catalog
Add a new tag to a record
Create transcription on National Archives Catalog
Add a new transcription
Delete comment on National Archives Catalog
Remove or deactivate a comment
Delete contributions on National Archives Catalog
Deactivate or remove multiple contributions
Delete tag on National Archives Catalog
Remove or deactivate a tag
Fetch coords on National Archives Catalog
Utility to fetch JSON data from S3 based on a provided URL
Get announcements on National Archives Catalog
Retrieve a list of all announcements
Get comment on National Archives Catalog
Retrieve a single comment by ID
Get comments by naid on National Archives Catalog
Retrieve comments for a specific record
Get comments by userid on National Archives Catalog
Retrieve comments by a specific contributor
Get contributions by target naid on National Archives Catalog
Retrieve contributions for a specific record ID
Get contributions by userid on National Archives Catalog
Retrieve contributions by user ID
Get justifications on National Archives Catalog
Retrieve a list of justifications for administrative actions
Get latest announcements on National Archives Catalog
Retrieve active announcements
Get record children on National Archives Catalog
Retrieve immediate children of a specified parent ID
Get record stats on National Archives Catalog
Retrieve statistics on user contributions
Get tag on National Archives Catalog
Retrieve a single tag by ID
Get tags by naid on National Archives Catalog
Retrieve tags for a specific record
Get tags by userid on National Archives Catalog
Retrieve tags by a specific contributor
Get transcription on National Archives Catalog
Retrieve a single transcription by ID
Get transcription history on National Archives Catalog
Retrieve transcription history
Get transcriptions by naid on National Archives Catalog
Retrieve transcriptions for a specific record
Get transcriptions by userid on National Archives Catalog
Retrieve transcriptions by a specific contributor
Get user on National Archives Catalog
Retrieve public data for a specific user
Get user notifications on National Archives Catalog
Retrieve user notifications
Get users on National Archives Catalog
Retrieve public account data (filterable by email, username, role, etc.)
Search comments on National Archives Catalog
Search for comment data
Search contributions on National Archives Catalog
Search for contribution data
Search records on National Archives Catalog
Search for records using URL parameters
Search records by comment on National Archives Catalog
Search records by comments
Search records by contribution on National Archives Catalog
Search records related to user contributions
Search records by tag on National Archives Catalog
Search records by tags
Search records by text on National Archives Catalog
Search records by other extracted text
Search records by transcription on National Archives Catalog
Search records by transcriptions
Search tags on National Archives Catalog
Search for tag data
Search transcriptions on National Archives Catalog
Search for transcription data
Update comment on National Archives Catalog
Update an existing comment
Update transcription on National Archives Catalog
Add or update a transcription
Update user on National Archives Catalog
Update user information
Connect National Archives Catalog to OpenAI Agents SDK via MCP
Follow these steps to wire National Archives Catalog into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the National Archives Catalog MCP Server
OpenAI Agents SDK provides unique advantages when paired with National Archives Catalog 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
National Archives Catalog + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the National Archives Catalog MCP Server delivers measurable value.
Automated workflows: build agents that query National Archives Catalog, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries National Archives Catalog, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through National Archives Catalog tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query National Archives Catalog to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for National Archives Catalog in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with National Archives Catalog immediately.
"Search for records related to the 'Apollo 11 mission'."
"Get the immediate children of parent record 573036."
"Find all tags associated with record NaId 123456."
Troubleshooting National Archives Catalog MCP Server with OpenAI Agents SDK
Common issues when connecting National Archives Catalog to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
National Archives Catalog + OpenAI Agents SDK FAQ
Common questions about integrating National Archives Catalog MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
Lichess.org Open Chess Intelligence
10 toolsThe definitive server for Lichess.org — monitor live broadcasts, analyze player stats, and solve puzzles via AI.

E2B
3 toolsSecure cloud sandboxes for AI code execution — run Python, JavaScript, and shell commands in isolated Firecracker microVMs with ~150ms cold start.

KnowBe4 (KMSAT Reporting)
10 toolsAudit security awareness — list users, track phishing tests, and monitor risk scores.

Culture Amp
10 toolsEquip your AI agent to manage employee engagement surveys, monitor performance, and track development via the Culture Amp API.
