How to Use the Macaulay Library MCP in Windsurf

Q: How does Windsurf use the Macaulay Library MCP server to build training datasets?

Cascade reads your target species list and runs searchmedia to locate relevant audio recordings. It then calls getasset to pull the precise metadata and downloads the high-quality files directly into your training pipeline.

Q: How do I configure this MCP Server in my Windsurf workspace?

Add the server configuration to your mcpconfig.json file under the mcpServers key. Cascade will automatically discover the tools and start using them during your coding sessions.

Run automated bioacoustic analyses and fetch wildlife media directly inside Windsurf using Cascade's multi-step planning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Macaulay Library MCP to Windsurf

Create your Vinkius account to connect Macaulay Library 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 Macaulay Library with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query the Global Wildlife Archive via Windsurf

`search_media` queries the Macaulay Library database to return audio and video recordings of specific animal species. Your agent reads your local codebase, identifies which species codes you need, and runs the search without requiring manual intervention. Cascade chains this search with your local data pipeline using the MCP server. It extracts the matching media URLs and downloads them to your project directory, formatting the dataset for immediate training.

Inspect Asset Metadata Automatically

`get_asset` fetches deep metadata for any specific media file, including location coordinates, date, and recording equipment. This tool lets the agent verify the quality of the recording before adding it to your local training set. You get exact coordinates and observer details to filter out low-quality or geographically biased recordings. Cascade writes these metrics directly into your dataset manifest file.

Track Live Citizen Science Uploads

`get_recent_media` pulls the latest wildlife recordings uploaded by contributors worldwide. The agent monitors this real-time stream to detect seasonal migrations or sudden spikes in regional bird activity. By hooking this tool into your active workspace, Cascade builds automated dashboards that update whenever new field recordings match your target list. You stay current with actual field observations without leaving your editor.

Setup guide

Set up Macaulay Library 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 Macaulay Library 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 Macaulay Library payment history." If connected, Cascade will call the Macaulay Library tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "macaulay-library-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 Macaulay Library. 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 Macaulay Library 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 Macaulay Library MCP in Windsurf

Cascade reads your target species list and runs `search_media` to locate relevant audio recordings. It then calls `get_asset` to pull the precise metadata and downloads the high-quality files directly into your training pipeline.

Yes. You can tell Cascade to inspect the metadata returned by `get_asset` for each search result. It will automatically filter out low-grade recordings and only save files that meet your minimum quality threshold.

Yes, Cascade can write a script that loops through species codes, queries the archive, and downloads the raw media files directly to your workspace. It handles the entire sequence in a single run.

Add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Cascade will automatically discover the tools and start using them during your coding sessions.

Vinkius runs this server inside an isolated, zero-trust V8 sandbox. Your search queries and requested asset IDs are processed ephemerally, ensuring no log of your research parameters or proprietary target species lists is ever stored or leaked.

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