# Kannapedia Genetics MCP

> Kannapedia Cannabis Genetics provides structured access to a vast database of cannabis strains. Use this MCP to search by specific terpenes, filter results based on reported effects (like focus or sleep), identify genetics by name, and view full strain lineage data.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** genetics-database, terpenes, strain-analysis, botany, data-search

## Description

This connector gives your AI client direct access to the Kannapedia genetics database. Instead of wading through general web searches, you can ask natural language questions about cannabis strains. For instance, 'I need a high-Myrcene strain that provides focus.' The system finds specific strains based on complex chemical profiles and reported effects.

It's useful for anyone who needs precise data—from hobbyist budtenders to academic researchers. You can run specialized queries like searching by dominant terpenes or filtering only for sedative effects, then retrieve the full lineage and description for any strain found. Connecting this MCP via Vinkius gives you a single point of access to these structured genetics datasets, letting your agent perform detailed lookups without needing multiple APIs.

## Tools

### search_by_effect
Locates strains that are reported to cause a certain physiological effect.

### get_strain_detail
Fetches the full lineage and description for one specific strain name.

### search_genetics
Searches for cannabis strains using general keywords or strain names.

### search_by_terpene
Filters the database to find strains dominated by a specific chemical terpene.

## Prompt Examples

**Prompt:** 
```
Search for strains high in Limonene.
```

**Response:** 
```
Found 3 strains: 1. Super Lemon Haze. 2. Banana Kush. 3. Do-Si-Dos.
```

**Prompt:** 
```
Show me details for OG Kush.
```

**Response:** 
```
OG Kush (Hybrid): Lineage: Chemdawg x Lemon Thai x Pakistani Kush. Effects: Euphoric, Happy, Relaxed.
```

**Prompt:** 
```
Find strains that help with Sleep.
```

**Response:** 
```
Found 5 strains: 1. Granddaddy Purple. 2. Northern Lights. 3. 9 Pound Hammer.
```

## Capabilities

### Search by Chemical Profile
Find strains containing specific dominant chemical compounds, such as Myrcene or Limonene.

### Filter by Desired Outcome
Identify genetics associated with reported physiological effects like relaxation or energy boost.

### Retrieve Full Strain Data
Pull complete genetic lineage and descriptive information for any specific strain name.

### Execute Keyword Searches
Perform general searches across the database using common names or keywords.

## Use Cases

### A customer needs a sleep aid with specific chemistry.
The budtender asks the AI client to find strains that are both associated with 'Sleep' (using `search_by_effect`) and contain high amounts of Myrcene. The system returns a list of candidates, allowing the budtender to recommend the best option.

### A researcher needs lineage data for comparison.
The researcher asks the AI client for the full details on 'OG Kush' using `get_strain_detail`. The agent returns the complete genetic background and effect profile needed for their analysis.

### Finding alternatives based only on scent/profile.
The user wants to explore strains that smell like lemon. They ask the AI client to query by 'Limonene' using `search_by_terpene`, getting a list of candidates they would otherwise miss.

### General market research on new compounds.
The user wants to see all strains mentioned in the database that are associated with 'Focus.' They use `search_by_effect` and get a comprehensive set of options for further investigation.

## Benefits

- Precision search: Use the `search_by_terpene` tool to isolate strains based on exact chemical compounds like Myrcene, rather than relying on general descriptions.
- Targeted results: Need a strain for sleep? The `search_by_effect` tool lets you filter thousands of options down to those associated with that specific outcome.
- Deep data access: Instead of just getting a name, the `get_strain_detail` function provides full genetic lineage and detailed descriptions in one call.
- Broad discovery: If you don't know what specific effect or terpene you need, start with `search_genetics` to find relevant strains by keyword.
- Saves time: Your agent handles the complex database querying. You simply ask what you want, and it returns structured data instantly.

## How It Works

The bottom line is that you get precise, structured data on cannabis genetics without leaving your AI client.

1. First, subscribe to this MCP and provide your Kannapedia API key within Vinkius.
2. Next, ask your AI client a specific question—for example, 'Show me strains for sleep.'
3. The agent uses the specialized tools to query the database and returns a list of matching strains with detailed information.

## Frequently Asked Questions

**How do I get my Kannapedia API Key?**
Sign up on the Kannapedia website, navigate to your account settings, and generate a new API key for developer access.

**Can I search for specific terpenes?**
Yes, the search_by_terpene tool allows you to find strains known for dominant terpenes like Myrcene, Limonene, or Caryophyllene.

**Does it include lineage and parentage?**
Yes, the get_strain_detail tool provides full lineage data, including parent strains and genetic background for each entry.

**Can I filter strains by their reported effects?**
Yes! Use the search_by_effect tool to discover strains associated with specific effects such as Sleep, Focus, or Relaxation.

**What detailed information does the `get_strain_detail` tool return?**
It returns comprehensive data on a single strain. You'll get its full lineage, descriptive profile, and all associated reports, making it perfect for deep-dive analysis.

**Should I use `search_genetics` or another tool if I only know the name of a plant?**
Use `search_genetics`. This tool is designed for broad discovery. It allows you to search strains using keywords or names, giving you results even if you don't specify a terpene or effect.

**If I run `search_by_terpene`, how accurate are the dominant profiles? **
The tool searches based on the strain's reported dominant terpenes, such as Myrcene or Limonene. This helps you quickly narrow down results to specific aromatic compounds.

**What kind of data structure can I expect when using `search_by_effect`?**
The tool returns a list of strains associated with the reported effect (like Sleep or Focus). The output is structured, which makes it easy for your AI client to process and analyze.