# Cannlytics Strain API MCP

> Cannlytics Strain API lets you connect structured, open cannabis data directly into your AI client. Use this MCP to search for strains by keyword, pull detailed strain profiles, analyze reported effects and flavor notes, or map out genetically similar alternatives. It provides a consistent source of scientific metadata for researchers and industry professionals.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** strain-data, cannabis-science, open-data, chemical-analysis, botany, api-access

## Description

This connector streams structured data about cannabis genetics and chemistry directly from the Cannlytics database into your AI client. Instead of navigating external websites or cross-referencing multiple PDFs, you ask your agent to pull specific data points—like positive medical effects, reported flavor profiles (citrus, earthy), or key characteristics—and get a clean, usable output. You can use the Vinkius catalog to connect this API and have your AI client perform complex queries through natural conversation. This capability is critical for comparative analysis; you're not just reading facts, you’re running data sets on demand. Whether you’re validating product claims or building market reports, this MCP gives you immediate access to structured strain information.

## Tools

### get_effects
Retrieves the reported positive, negative, and medical effects for a specified strain.

### get_flavors
Extracts the specific flavor profile data (e.g., citrus, earthy) associated with a given strain.

### get_strain
Pulls the full, detailed metadata package for a single, specific cannabis strain name.

### search_strains
Searches the entire database and returns multiple strains matching a keyword or search parameter.

### get_similar_strains
Compares and lists strains that share genetic markers or characteristics with an input strain.

## Prompt Examples

**Prompt:** 
```
Search for strains with 'Blue' in the name.
```

**Response:** 
```
Found 5 strains: 1. Blue Dream. 2. Blueberry. 3. Blue Cheese. 4. Blue Cookies.
```

**Prompt:** 
```
What are the effects of Sour Diesel?
```

**Response:** 
```
Effects: Energetic, Uplifted, Creative (Positive). Dry Mouth, Anxious (Negative). Stress, Pain (Medical).
```

**Prompt:** 
```
Show me strains similar to OG Kush.
```

**Response:** 
```
Similar strains: 1. Skywalker OG. 2. Bubba Kush. 3. Master Kush.
```

## Capabilities

### Identify candidate strains
Search the entire database using keywords (e.g., 'blue,' 'high potency') to find lists of potential cannabis strains.

### Retrieve detailed strain metadata
Fetch a complete, singular data profile for any specific strain name provided.

### Analyze reported physiological effects
Pull structured data detailing the positive, negative, or medical effects associated with a given strain.

### Extract flavor and aroma profiles
Get specific notes for a strain, such as citrus, earthy, or sweet, that define its taste profile.

### Map related genetic alternatives
Discover strains that share similar genetics or characteristics with a known starting strain.

## Use Cases

### Developing Product Documentation
A consultant needs to write technical documentation comparing three strains. Instead of visiting three different websites, they ask their agent to use search_strains() first, then run get_strain(), get_effects(), and get_flavors() sequentially on the top results, compiling all data into one report.

### Identifying Research Leads
A biochemist is investigating unique psychoactive compounds. They use search_strains() with broad parameters to find candidates, then feed those names into get_similar_strains() and get_strain() to narrow down the most genetically promising leads for study.

### Cross-checking Claims
A client claims their product is 'energetic and citrus.' The user directs their agent to check both get_effects() (for 'energetic') and get_flavors() (for 'citrus') against a specific strain, immediately confirming or refuting the claim with hard data.

### Troubleshooting Ingredient Lists
A formulator receives an ingredient list referencing an unknown strain. They use search_strains() to identify the name and then run get_strain() to confirm if the metadata is sufficient for their formulation requirements.

## Benefits

- You gain immediate access to detailed data. Instead of manually checking multiple sources for a single strain's profile, calling get_strain() gives you the complete metadata package instantly.
- Comparative analysis becomes straightforward. Need to know what’s related? Use get_similar_strains() to map out genetically linked alternatives without leaving your agent interface.
- Validate product claims with precision. You can isolate specific data points, running separate calls for get_effects() and get_flavors(), providing a granular view of the strain's chemistry.
- Efficiency in discovery: The search_strains() tool lets you bypass individual lookups entirely, allowing you to quickly build lists of potential strains based only on keywords.
- Structured data output eliminates ambiguity. Every piece of information—be it flavor or effect—returns in a clean format that your agent can immediately parse for scientific writing.

## How It Works

The bottom line is, your AI client treats this entire database like an accessible function call, allowing complex queries without needing external API coding.

1. Subscribe to this MCP and supply your Cannlytics API Key.
2. Connect your preferred AI client, giving it access to the Vinkius catalog tools.
3. Ask your agent a question, specifying which strain data points you need (e.g., 'What are the medicinal effects of Strain X?') and receive the structured output.

## Frequently Asked Questions

**How do I get my Cannlytics API Key?**
Sign up on the Cannlytics platform, navigate to your account settings, and generate a new API key.

**Can I see medical effects for strains?**
Yes, the get_effects tool returns positive, negative, and medical effects reported by users for each strain.

**Does it include flavor profiles?**
Yes, use the get_flavors tool to see detailed flavor descriptors like earthy, sweet, citrus, and more.

**Can I find similar strains to one I already know?**
Yes! Use the get_similar_strains tool to discover related strains based on genetics and shared characteristics.

**How do I best use the `search_strains` tool to find strains by name or keyword?**
Just provide a simple text query for immediate results. The tool searches across the entire Cannlytics database, letting you discover available strains based on keywords or partial names.

**What specific data fields does the `get_strain` tool return?**
It returns a comprehensive profile for the strain. You'll get detailed information beyond just effects and flavors, including genetics, common uses, and full descriptive write-ups.

**If I use `get_similar_strains` for a rare or obscure strain, are there limits on results?**
No. The system analyzes the genetic data of that specific strain to find related options. You'll get a full list of comparable strains based on shared characteristics.

**What should I do if `get_strain` or `search_strains` gives me no results?**
First, check your spelling and be sure the strain name is current. If it still fails, try using a broader keyword with `search_strains` instead of a precise name.