How to Use the iNaturalist MCP in Windsurf

Use the iNaturalist MCP Server in Windsurf to pull live biodiversity data directly into your coding context.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect iNaturalist MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search and filter wildlife records

Cascade uses `search_observations` to grab specific data points from the field. You get back exact locations, observer details, and photo metadata without leaving your editor. This lets you build data-driven apps by querying `search_taxa` for hierarchy details. Cascade chains these calls to populate your local state with real-world biological stats.

Analyze identification patterns

The `get_identifications` tool provides a clear window into how the community verifies species. You can track who proposed an ID and which observation triggered the review. Automate your research by piping these results into your scripts. Cascade handles the multi-step logic, connecting `get_observation` with user-specific data to map out identification accuracy.

Manage project data

Fetch active community projects using `get_projects` to see what researchers are currently tracking. It gives you immediate access to organized collections of observations in any given area. Combine this with `get_species_counts` to generate reports on local biodiversity. Windsurf processes the responses to give you a clean view of the most common species in your defined region.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "inaturalist-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 iNaturalist. 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 iNaturalist 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 iNaturalist MCP in Windsurf

Yes. Once you connect the server, you can ask Cascade to find observations or species counts. It runs the tools and brings the data back into your chat window.

It absolutely does. You can write code that consumes the JSON output from the tools, allowing you to build features that rely on live wildlife data.

Just ask Cascade to pull the species counts for a specific location or taxon. The server executes `get_species_counts` and returns the aggregated data for your analysis.

The server only retrieves public observation data from the platform. It does not store your local files or credentials, ensuring your session remains isolated.

Go to your settings menu and locate the MCP configuration. Add the server details there, click refresh, and Cascade will automatically detect the available tools.

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