# Perenual Plant API MCP

> Perenual Plant API manages botanical research and plant auditing directly through your agent. Instead of navigating multiple gardening portals or cross-referencing databases, you ask your client about species care, identify diseases, or audit specific requirements instantly. It turns complex data retrieval into a simple conversation.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** botany, plant-care, species-database, gardening, horticulture

## Description

The Perenual Plant API gives your agent direct access to structured data for botanical research and auditing. When you hook this server up to your AI client, you can manage complex plant knowledge through simple conversation. You don't have to jump between multiple gardening portals or cross-reference databases; you just ask your agent about a species, its needs, or what might be wrong with it.

**`search_plants`** lets you find records for thousands of species when you only know the common name or the scientific designation. You simply tell your agent to look up 'Rose' or *Rosa gallica*, and it returns core IDs and essential metadata across all matching plants. This tool is how you start any research project, getting you off the ground with a list of potential candidates.

**`get_plant_details`** pulls deep classification data for any species ID you hand to it. If you already know the unique identifier for a plant, this function delivers high-resolution metadata—the full picture of that specific life form. It's your deep dive tool when you need more than just basic identification; you get its formal scientific standing and detailed classification traits.

Need to know if the whole system is ready for action? You run **`check_api_status`**. This verifies whether the Perenual service is up and running. Before you start crunching numbers or calling complex queries, you check this first. It confirms that all your data requests will actually get processed.

When it comes to maintenance, your agent handles all the heavy lifting with **`get_plant_care_guide`**. Give it a species ID, and it instantly pulls the specific care instructions—everything from how often to water or what kind of light exposure it needs. You'll know exactly what that plant requires without having to consult a printed manual or an external website.

If you suspect something’s wrong with your collection, **`search_plant_diseases`** runs a search for common pests and diseases. It doesn't just say 'bad'; it lists specific biological markers and relevant information on what the problem is and how to identify it. This keeps you ahead of potential issues in your greenhouse or garden.

When you combine these tools, you get an auditing capability that’s hard to beat. You can start by using **`search_plants`** with a common name to narrow down options. Then, if the initial results are vague, you use **`get_plant_details`** on a promising candidate's ID for full metadata. If everything looks good, but you’re worried about its upkeep, you run **`get_plant_care_guide`** to check watering frequency and light needs against your current setup. You can then pass that same species ID into **`search_plant_diseases`** to confirm there aren't any common pests associated with it. If the whole process is critical, you always run **`check_api_status`** first. It’s a complete cycle of verification and data gathering, all managed through your agent in plain conversation.

This setup means you never have to stop what you're doing to consult another service or database. You just talk to your client, and it handles the complex retrieval process for species identification, care auditing, disease diagnosis, and status checks. It keeps every piece of botanical data verified and right where you need it.

## Tools

### check_api_status
Verifies if the Perenual service is currently running and available for queries.

### get_plant_care_guide
Retrieves specific care instructions, like watering schedules or light exposure, for a single species ID.

### get_plant_details
Fetches comprehensive details and classification data when you provide a plant's unique species ID.

### search_plant_diseases
Searches for known common pests and diseases, listing relevant biological markers to watch out for.

### search_plants
Finds plant records by asking for a species' common or scientific name.

## Prompt Examples

**Prompt:** 
```
Search for 'monstera' using Perenual Plant API.
```

**Response:** 
```
I've retrieved the data for Monstera! Multiple species are identified, including Monstera Deliciosa and Monstera Adansonii. Would you like the care requirements or species ID for any of these?
```

**Prompt:** 
```
What is the care guide for species ID 5257?
```

**Response:** 
```
I've retrieved the care guide for ID 5257. It requires frequent watering and bright, indirect sunlight. I can provide the full maintenance breakdown and pruning metadata if you'd like.
```

**Prompt:** 
```
Search for plant diseases related to 'root rot'.
```

**Response:** 
```
I've identified several conditions related to root rot. Notable markers include yellowing leaves and mushy stems. I can provide the recommended treatment and prevention steps for these issues.
```

## Capabilities

### Search by name
You can ask the agent to look up plants using their common or scientific names.

### Retrieve care guides
The agent pulls specific maintenance instructions—like watering frequency and sunlight needs—for a given plant ID.

### Get full species metadata
You obtain detailed records for a known plant by submitting its unique species identifier.

### Identify diseases/pests
The agent searches databases to list common plant pests and associated biological markers.

### Check system status
You verify that the Perenual service is currently operational before running critical data queries.

## Use Cases

### Identifying a new species problem
A botanist finds an unknown plant. They first use `search_plants` to narrow down potential matches using the common name, then run `get_plant_details` on the top candidate ID to verify if it matches their classification notes.

### Preventing a crop outbreak
A greenhouse manager notices yellowing leaves. They immediately use `search_plants` to list all plants in that zone, then run `search_plant_diseases` with keywords like 'yellow leaf' to get recommended protocols and prevent the issue from spreading.

### Quick maintenance planning
Before a large planting project, an agent runs `get_plant_care_guide` for five different species. This aggregates all necessary watering, sunlight, and pruning requirements into one actionable checklist for the team lead.

### Validating research data points
A researcher needs to confirm the exact habitat markers of a rare plant. They use `search_plants` first, then call `get_plant_details` using the species ID to ensure all metadata aligns with their current hypothesis.

## Benefits

- Saves time on field research. Instead of opening a database and manually searching by name, you simply ask your agent to `search_plants` for any species, getting IDs and names in one shot.
- Automates maintenance checks. Need to know if 'Fiddle Leaf Fig' needs more sun? Call `get_plant_care_guide` directly. You get immediate watering/light requirements without leaving the chat.
- Improves proactive management. When spotting weird leaf discoloration, use `search_plant_diseases`. The agent identifies potential issues and lists relevant markers for your greenhouse team.
- Deepens research capability. If you find a species ID but need more background, run `get_plant_details` to pull high-resolution classification data that supports deep botanical work.
- Reliability check built in. Before running any major queries, you can quickly confirm the system's health by calling `check_api_status`, ensuring your research doesn't fail mid-flow.

## How It Works

The bottom line is: your AI client executes specific API calls against Perenual's database when you ask a natural language question.

1. Subscribe to the server and input your unique Perenual API Key.
2. Connect the MCP Server to your AI client (e.g., Claude or Cursor).
3. Ask your agent a question, like 'What are the care needs for Monstera?', and it runs the necessary tools in sequence.

## Frequently Asked Questions

**How do I find a plant's ID to use with get_plant_care_guide?**
You must first run `search_plants` using the common or scientific name. The search results will provide you with the necessary species IDs needed for the care guide tool.

**Can I check if the Perenual Plant API is working before running searches?**
Yes, use the `check_api_status` tool. This quick call verifies that the entire service is operational and ready to accept queries from your agent.

**What kind of diseases can I search for with search_plant_diseases?**
You can search for common plant pests and diseases. The tool provides relevant biological markers, helping you identify the specific symptoms associated with known issues.

**Is get_plant_details better than search_plants?**
`search_plants` finds general records by name. `get_plant_details`, however, requires a specific ID and returns deeper, high-resolution classification metadata for that exact species.

**How do I handle rate limits when using search_plants?**
The API adheres to standard usage quotas. If you exceed the allowed number of requests in a minute, your agent will receive a 429 status code. You'll need to implement a backoff delay before retrying the call.

**When calling get_plant_care_guide, what format must the species ID be in?**
The species ID must be provided as a single integer string. The system cannot process IDs embedded within larger text blocks; ensure it's clean data.

**Does search_plants distinguish between common and scientific names?**
Yes, the tool handles both inputs simultaneously. You can use either a known common name or a Latin binomial to initiate the search for matching species records.

**What kind of metadata do I get when running get_plant_details?**
You receive high-resolution data including full classification, specific maintenance distributions, and unique IDs. This metadata is designed for deep botanical analysis beyond basic care guides.

**How do I find my Perenual API Key?**
Register for a free or paid account at [**perenual.com/docs/api**](https://perenual.com/docs/api), and you will find your API Key in your dashboard. Copy and paste it below.

**Does it support disease identification?**
Yes. The `search_plant_diseases` tool allows your agent to audit common pests and diseases and retrieve recommended solutions.

**Are care guides included for all species?**
Yes. The `get_plant_care_guide` tool retrieves specific maintenance instructions including watering frequency and sunlight exposure for most species.