• BIOLOGY
  • TAXONOMY
  • IDENTIFICATION
  • HUMAN

How to retrieve botanical species metadata with your AI

Connect the Perenual Plant API to your agent. Once linked, your AI can fetch deep biological data for any species ID you provide.

Ask AI about this page

Short answer

How can I get botanical metadata using my AI?

Give your AI a unique species ID to pull biological markers and classification data. Your agent uses the Perenual Plant API to fetch these details for you. You'll get specific species profiles for your research.

Data outcomes

What your agent finds

The specific information your agent pulls from the API.

BIOLOGY

Biological markers

The AI fetches specific physiological data points. You get the raw biological facts for the species.

TAXONOMY

Classification data

Your agent retrieves the taxonomic hierarchy. This places the plant in its correct biological group.

IDENTIFICATION

Species profiles

The AI pulls detailed traits for a specific ID. You get a complete picture of the plant's characteristics.

HUMAN

Manual analysis

The AI provides the raw data points. You must decide which markers are relevant to your specific study.

The workflow

What your AI does when the ID arrives.

The agent handles the API calls so you can focus on the data.

  1. Receive ID

    Your agent takes the species ID from your chat and prepares the request.

    get_plant_details
  2. Fetch data

    The agent calls the API to pull the biological markers and classification data.

    get_plant_details
  3. Process response

    The AI parses the raw botanical data into a clean format.

    get_plant_details
  4. Deliver info

    Your agent presents the species metadata directly in your chat window.

    get_plant_details

Try it

Copy these to start.

Use these prompts to query the Perenual Plant API.

Starting points

Swap the plant IDs in these examples with the ones you actually need.

Perenual Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_rXvGkNmwX3ZQu74dXxzduXAmP5tKDCrRyH3wgRm6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Perenual capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "perenual-plant-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_rXvGkNmwX3ZQu74dXxzduXAmP5tKDCrRyH3wgRm6/mcp"
    }
  }
}
Copy into chat04
  • Get the biological metadata for plant ID 1482.

  • What are the classification details for species ID 5521?

  • Retrieve the botanical profile for plant ID 120.

  • Find the biological markers for species 993.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Perenual Plant API once, then ask.

One click connects the API to your agent. Your credentials stay encrypted on our side.

Connect Perenual Plant API to your AI

FAQ

How this task behaves

  • 01

    Can my AI search for plants by name?

    No. This tool requires a specific species ID to function.

  • 02

    Can the AI change plant data in the API?

    No. The AI can only read metadata; it cannot edit the Perenual database.

  • 03

    Do I need to manage API keys in my AI client?

    No. Vinkius manages the connection and credentials for you.

  • 04

    Can the AI compare two different species?

    Yes. If you provide two IDs, your agent can fetch both and compare the data.

  • 05

    Will the AI automatically save this data to my files?

    No. The AI retrieves the data for your chat. You must save any information you want to keep.

  • More questions about Perenual Plant API? The Connector page answers them. See everything the Perenual Plant API Connector can do

Connect Perenual to Claude, Cursor, ChatGPT & more