Bring Historical Records
to Windsurf
Learn how to connect National Archives Catalog to Windsurf and start using 40 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the 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.
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.
How it works
- Subscribe to this server
- Enter your NARA API Key
- Start researching history from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Historians & Researchers — instantly retrieve primary source documents and metadata without manual catalog navigation.
- Educators — find relevant historical photos and records to build curriculum materials directly from a chat interface.
- Genealogists — search through millions of records and transcriptions to find family history data and archival links.
Built-in capabilities (40)
Add a new comment to a record
Add a new tag to a record
Add a new transcription
Remove or deactivate a comment
Deactivate or remove multiple contributions
Remove or deactivate a tag
Utility to fetch JSON data from S3 based on a provided URL
Retrieve a list of all announcements
Retrieve a single comment by ID
Retrieve comments for a specific record
Retrieve comments by a specific contributor
Retrieve contributions for a specific record ID
Retrieve contributions by user ID
Retrieve a list of justifications for administrative actions
Retrieve active announcements
Retrieve immediate children of a specified parent ID
Retrieve statistics on user contributions
Retrieve a single tag by ID
Retrieve tags for a specific record
Retrieve tags by a specific contributor
Retrieve a single transcription by ID
Retrieve transcription history
Retrieve transcriptions for a specific record
Retrieve transcriptions by a specific contributor
Retrieve public data for a specific user
Retrieve user notifications
Retrieve public account data (filterable by email, username, role, etc.)
Search for comment data
Search for contribution data
Search for records using URL parameters
Search records by comments
Search records related to user contributions
Search records by tags
Search records by other extracted text
Search records by transcriptions
Search for tag data
Search for transcription data
Update an existing comment
Add or update a transcription
Update user information
Why Windsurf?
Windsurf's Cascade agent chains multiple National Archives Catalog tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 40 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 40 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
National Archives Catalog in Windsurf
National Archives Catalog and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect National Archives Catalog to Windsurf through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for National Archives Catalog in Windsurf
The National Archives Catalog 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. All 40 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Windsurf only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* 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
How Vinkius secures
National Archives Catalog for Windsurf
Every tool call from Windsurf to the National Archives Catalog MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I search for records specifically by the text in their transcriptions?
Yes. Use the search_records_by_transcription tool. This is particularly useful for handwritten documents that have been digitized and transcribed by volunteers.
How do I see the individual items within a larger archival series?
Use the get_record_children tool with the parent NaId. This will list the immediate sub-records or files contained within that specific collection or series.
Can I contribute to the archives by adding tags via the AI?
Yes, the create_tag tool allows you to add descriptive tags to a record using its National Archives Identifier (NaId), helping improve searchability for the community.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
BIMobject
10 toolsAccess BIMobject marketplace — search building products, download technical files, and manage manufacturer data directly from any AI agent.
Buddy Punch
6 toolsTrack employee hours with GPS-verified clock-ins, PTO management, and payroll-ready timesheet exports your team will love.
Mail-in-a-Box
9 toolsManage mail users, aliases, and system health via the Mail-in-a-Box REST API.
Crafter CMS
10 toolsManage headless content via Crafter CMS — execute GraphQL queries, write Git-based XML content, and publish to delivery engines directly from any AI agent.