How to Use the iNaturalist MCP in VS Code Copilot

Q: Can VS Code Copilot help me write tests for iNaturalist data models?

Yes, your agent can run getobservation to retrieve a real observation payload. It will then use that exact JSON structure to generate robust Jest or PyTest unit tests.

Q: How do we check the most common species in a specific region?

Your agent can invoke getspeciescounts with a location filter. This returns a ranked list of species, which you can use to populate dropdowns or test geographical dashboards.

Connect VS Code Copilot to live biodiversity databases and taxonomic registries for team-wide development.

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 VS Code Copilot

Create your Vinkius account to connect iNaturalist to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enable team-wide biodiversity integrations via MCP Server

This MCP Server setup lets every developer on your team use `search_observations` to fetch live environmental data. Keep your entire engineering team aligned by committing your tool configurations directly to your repository. Instead of everyone setting up separate sandbox accounts, your team shares a secure, managed endpoint. Your agent can instantly fetch raw data payloads to debug production issues or test new features.

Validate scientific classifications in your editor

This MCP Server lets your agent call `get_taxon` and `search_taxa` to verify scientific names and conservation ranks directly in VS Code. Building apps for ecological research requires highly accurate species classification. By using `autocomplete_taxa`, developers can quickly find the exact taxon IDs needed for seed data or test suites. This prevents bad data from ever entering your codebase.

Fetch validated community records

Your agent uses `get_identifications` to check who confirmed a specific sighting. When building tools for field researchers, you need to verify data quality and filter out unverified records. You can also pull community-led efforts with `get_projects` or use `get_observations_by_user` to test user-facing profiles. This makes it easy to build features that rely on community-curated data.

Setup guide

Set up iNaturalist MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the iNaturalist MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the iNaturalist tools listed. Try asking: "List my recent iNaturalist transactions" and Copilot will invoke them automatically.

.vscode/mcp.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 VS Code Copilot

Create a .vscode/mcp.json file in your project root and commit it to your Git repository. Anyone on your team using VS Code Copilot will instantly get access to the tools.

Yes, your agent can run `get_observation` to retrieve a real observation payload. It will then use that exact JSON structure to generate robust Jest or PyTest unit tests.

The server handles connections efficiently, but you should respect the platform's standard limits. Vinkius manages the endpoint to ensure your team gets stable, reliable access during development.

Your agent can invoke `get_species_counts` with a location filter. This returns a ranked list of species, which you can use to populate dropdowns or test geographical dashboards.

Security is built-in. Vinkius runs the server in an isolated, ephemeral V8 sandbox, meaning your proprietary code and sensitive user IDs are never stored or exposed to external networks.

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