Do I need an iNaturalist account?

No! All public endpoints work without authentication. Just start searching. For write operations (creating observations, identifications), you'd need OAuth2 authentication.

What kind of species data is available?

iNaturalist has 150M+ observations of plants, animals, fungi, insects and more. Each observation includes species ID, photos, location, date, observer info and community identifications.

Can I search for species in my area?

Yes! Use search_observations with place_id, or lat/lng/radius parameters to filter by location. You can also use get_species_counts with place_id to see which species are most commonly observed in an area.

iNaturalist MCP Server for Mastra AI 10 tools — connect in under 2 minutes

Name: iNaturalist
Availability: InStock
Author: Vinkius

docs.mastra.ai/docs/agents/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect iNaturalist through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

typescript

import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";

async function main() {
  // Your Vinkius token. get it at cloud.vinkius.com
  const mcpClient = await createMCPClient({
    servers: {
      "inaturalist": {
        url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
      },
    },
  });

  const tools = await mcpClient.getTools();
  const agent = new Agent({
    name: "iNaturalist Agent",
    instructions:
      "You help users interact with iNaturalist " +
      "using 10 tools.",
    model: openai("gpt-4o"),
    tools,
  });

  const result = await agent.generate(
    "What can I do with iNaturalist?"
  );
  console.log(result.text);
}

main();

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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

About iNaturalist MCP Server

Connect to iNaturalist and explore the world's largest biodiversity database through natural conversation — no API key needed for public data.

Mastra's agent abstraction provides a clean separation between LLM logic and iNaturalist tool infrastructure. Connect 10 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

What you can do

Observations — Search millions of wildlife observations with species IDs, photos and locations
Taxa Search — Find species by name with scientific names, common names and conservation status
Species Counts — Get species observation counts by area, user or taxon
Identifications — Browse community identifications and expert species IDs
Projects — Discover community-curated biodiversity projects
User Activity — View any user's observation history

The iNaturalist MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect iNaturalist to Mastra AI via MCP

Follow these steps to integrate the iNaturalist MCP Server with Mastra AI.

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.ts and run with npx tsx agent.ts

Explore tools

Mastra discovers 10 tools from iNaturalist via MCP

Why Use Mastra AI with the iNaturalist MCP Server

Mastra AI provides unique advantages when paired with iNaturalist through the Model Context Protocol.

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add iNaturalist without touching business code

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

TypeScript-native: full type inference for every iNaturalist tool response with IDE autocomplete and compile-time checks

One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

iNaturalist + Mastra AI Use Cases

Practical scenarios where Mastra AI combined with the iNaturalist MCP Server delivers measurable value.

Automated workflows: build multi-step agents that query iNaturalist, process results, and trigger downstream actions in a typed pipeline

SaaS integrations: embed iNaturalist as a first-class tool in your product's AI features with Mastra's clean agent API

Background jobs: schedule Mastra agents to query iNaturalist on a cron and store results in your database automatically

Multi-agent systems: create specialist agents that collaborate using iNaturalist tools alongside other MCP servers

iNaturalist MCP Tools for Mastra AI (10)

These 10 tools become available when you connect iNaturalist to Mastra AI via MCP:

autocomplete_taxa

Returns the top 10 matching taxa with names and ranks. Useful for building search UIs or quickly finding taxon IDs. Autocomplete taxon names

get_controlled_terms

These include standardized values for life stage, plant phenology, sex, evidence of presence and more. Useful for understanding annotation options. Get controlled terms (standardized vocabularies)

get_identifications

Filter by taxon or user. Each identification includes the proposed species, the observation it was made on, and the user who made it. Get identifications made by users

get_observation

Get a specific iNaturalist observation by ID

get_observations_by_user

Filter by quality grade and set result limit. Returns observations with species, photos and dates. Get observations by a specific user

get_projects

Projects are community-curated collections of observations. Filter by place and set result limit. Search for iNaturalist projects

get_species_counts

Useful for biodiversity surveys and understanding which species are most commonly observed in an area or by a user. Filter by taxon, place or user. Get species observation counts grouped by taxon

get_taxon

Returns scientific name, common names, rank, ancestry, conservation status, establishment means and Wikipedia URL. Get details for a specific taxon

search_observations

Supports powerful filters: free-text query, taxon ID, user, place/location, quality grade (research/needs_id/casual), date range, and whether photos are required. Returns observations with species names, photos, locations, dates and observer info. Pagination: max 200 per page. Search iNaturalist observations

search_taxa

Returns taxa with scientific names, common names, ranks (species, genus, family, etc.), conservation status and observation counts. Supports filtering by rank. Search for taxa (species, genera, families, etc.)