How to Use the Internet Archive Search MCP in Windsurf

Q: Can I filter media formats using Internet Archive Search in Windsurf?

Yes, Windsurf uses the searchbymediatype tool to isolate specific formats like audio, texts, or software. Cascade can chain this with search to fetch only the exact file types your project requires.

Q: How do I discover popular or trending items in the archive?

The searchtopdownloads tool lets Cascade fetch the most popular items based on download metrics. You can pass an optional media type to find trending software or books.

Let Cascade autonomously crawl 40 million public domain records inside Windsurf using this MCP server.

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 Search MCP to Windsurf

Create your Vinkius account to connect Internet Archive Search to Windsurf 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 Search with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade chains multi-step research with this MCP Server

`faceted_search` gives Windsurf the power to analyze massive collections of historical records without manual digging. Cascade takes your high-level research goal, runs a broad query, and uses the resulting facets to map out its next moves. Instead of you typing ten prompts, this server lets the agent check `search_by_mediatype` to isolate audio files and then run `search_by_date_range` to find specific broadcasts. You get the exact files you need while Cascade handles the tedious sequence.

Drill down into historical metadata automatically

`search_by_creator` lets Windsurf find the complete works of specific authors or organizations instantly. The agent matches exact metadata strings against the Archive's database to bypass messy web search interfaces. When you need to verify publication details, Windsurf calls `search_by_publisher` to group items by their original printing houses. This direct API access means Cascade can cross-reference physical books against digital identifiers in seconds.

Target deep text content without leaving your code

`search_fulltext` searches through item descriptions to find specific terms across 40 million records. Windsurf reads these descriptions to extract historical context for your current workspace files. If you need to filter down to a specific era, Cascade combines this with `search_by_subject` to build a clean index of relevant items. You get a curated list of source materials without opening a single browser tab.

Setup guide

Set up Internet Archive Search MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Internet Archive Search MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Internet Archive Search payment history." If connected, Cascade will call the Internet Archive Search tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "internet-archive-search-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Search. 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 Search 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 Search MCP in Windsurf

Cascade reads your prompt and plans a multi-tool sequence across the Archive's 40 million items. It runs `faceted_search` to find the right categories, then executes specific tool calls to pull the files directly into your Windsurf workspace via MCP.

Yes, Windsurf uses the `search_by_mediatype` tool to isolate specific formats like audio, texts, or software. Cascade can chain this with `search` to fetch only the exact file types your project requires.

Windsurf handles large payloads by using the pagination parameters inside the `search` tool. Cascade automatically requests specific pages or limits rows to prevent overwhelming your context window.

The `search_top_downloads` tool lets Cascade fetch the most popular items based on download metrics. You can pass an optional media type to find trending software or books.

No, your raw search queries and metadata filters are processed locally within the Vinkius V8 sandbox. Only the final, anonymized API requests are sent to the Internet Archive endpoints to retrieve matching identifiers.

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