# Otreeba Cannabis API MCP > Otreeba Cannabis API connects your AI agent directly to verified cannabis data. Use it to search strains by name or effects, retrieve full lab reports for THC, CBD, and terpenes, and list every available brand. It's how you get structured, open-source product intelligence without having to click through multiple sites. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Tags:** cannabinoids, terpenes, lab-results, strain-data, brand-directory, data-verification ## Description Your AI client can connect straight to verified, open-source cannabis product intelligence using this server. It doesn't just give you vague info; it returns raw, structured data points. When you use your agent, it handles calling the precise function needed—whether you're checking lab results or mapping out market players. To find a strain, you run `search_strains` against the entire database using simple keywords to pull back matching cannabis names. Once you pinpoint a specific name, you can call `get_strain` and get that strain’s complete profile, including its full lineage and reported effects. For lab testing, there are two distinct functions. If you're dealing with whole flower products, you use `get_flower_lab_data`. This function pulls the detailed lab report for any given strain, providing exact cannabinoid and terpene percentages. When the product is an oil or concentrate extract, you switch to `get_oil_lab_data`. That tool fetches chemical profiles and test results specific to those oils. To track down who's making what, your agent manages brand intelligence. You can use `list_brands` to pull a complete directory of every company listed in the Otreeba database, so you know exactly which players are out there. Once you pick a name from that list, calling `get_brand` fetches all associated details about that specific producer or company. This setup lets your agent talk naturally—you tell it what data you need—and it calls the right tool to get the verifiable numbers. You're not relying on general web scraping; you're getting structured product intelligence directly into your workflow. ## Tools ### get_flower_lab_data Retrieves the full lab report for flower strains, including cannabinoid and terpene percentages. ### get_brand Fetches all details about a single, specific cannabis brand using its name. ### get_strain Pulls the complete profile, including effects and lineage, for any known cannabis strain. ### list_brands Lists every brand available in the Otreeba database so you can start investigating market players. ### get_oil_lab_data Gets lab test results and chemical profiles specifically for cannabis oils or extracts. ### search_strains Searches the entire strain database using keywords to discover matching cannabis strains. ## Prompt Examples **Prompt:** ``` Search for Indica strains that help with sleep. ``` **Response:** ``` Found 5 strains: 1. Granddaddy Purple. 2. Northern Lights. 3. Purple Kush. ``` **Prompt:** ``` Get the lab data for Blue Dream flower. ``` **Response:** ``` Lab Data: THC: 18.5%, CBD: 0.1%. Terpenes: Myrcene, Pinene, Caryophyllene. ``` **Prompt:** ``` List all cannabis brands in the database. ``` **Response:** ``` Found 15 brands: 1. Green Cultur. 2. Oasis. 3. Curo. 4. Bloom. ``` ## Capabilities ### Search strains by name or effect The agent runs a search query against the database, listing available cannabis strains that match your keywords. ### Get lab data for flower products It retrieves specific cannabinoid and terpene profiles (like THC/CBD) for any given strain's flower form. ### Get lab data for oil extracts The agent fetches detailed lab test results, including chemical breakdowns, specifically for cannabis oils or concentrates. ### List all available brands It pulls a complete directory of every brand listed in the Otreeba database so you know who's out there. ### Get details for a specific brand You pass a brand name, and the agent returns all associated information about that producer or company. ## Use Cases ### Verifying a purchase for a consumer A customer is worried about their product's potency. They ask their agent to run `get_flower_lab_data` on the specific strain name. The agent immediately returns the exact THC/CBD percentages and terpene breakdown, confirming what they paid for. ### Researching a new market segment An analyst needs to map out competitors. They first use `list_brands` to get all names, then run `get_brand` on each one to collect structured data points needed for a quarterly report. ### Assisting a customer at the counter A budtender knows the effects but not the name. They ask their agent to run `search_strains` using keywords like 'calm' or 'sleep.' The tool returns a list of matching strains, helping them guide the conversation. ### Cross-checking product types A user wants to compare flower vs. oil from the same brand. They first use `get_strain` for general info, then run both `get_flower_lab_data` and `get_oil_lab_data` sequentially to compare chemical profiles side-by-side. ## Benefits - Stop guessing on potency. Use `get_flower_lab_data` or `get_oil_lab_data` to pull specific, verifiable THC and CBD percentages directly from the lab report. You get raw numbers, not marketing claims. - Know your market. Running `list_brands` gives you a full directory of producers. Then, use `get_brand` to deep-dive into any company's history or product lines. - Speed up recommendations. Instead of reading long descriptions, ask the agent to run `search_strains`. It quickly finds strains matching effects (like sleep aid) or keywords. - Get full context on a strain. The `get_strain` tool gives you more than just name—you get its whole profile and lineage history in one call. - Compare products instantly. You can compare the flower data of one brand against the oil data of another, all through structured API calls. ## How It Works The bottom line is: your AI client acts as a translator, turning natural language questions into precise API calls that pull reliable product data. 1. Subscribe to the server and enter your Otreeba API Token into your AI client. 2. Prompt your agent with a specific data query (e.g., 'What are the terpenes for Strain X?'). 3. The agent executes the necessary tool call (like `get_flower_lab_data`) and returns structured, verified data to you. ## Frequently Asked Questions **How do I get my Otreeba API Token?** Go to the Otreeba website, create an account or log in, and find your API credentials in the developer or account settings section. **Does it include lab test results for THC and CBD?** Yes! The get_flower_lab_data and get_oil_lab_data tools return exact percentages for cannabinoids including THC, CBD, and full terpene profiles. **Can I search for specific strain effects?** Yes, the search_strains tool allows you to search by keywords including common effects like 'relaxing', 'energetic', or 'focus'. **Can I find the seed company or lineage for a strain?** Yes! Use the search_strains tool to find seed company and lineage information for specific strains in the database. **How do I check the terpene profile for a flower using `get_flower_lab_data`?** The tool returns detailed cannabinoid and terpene profiles. You get a breakdown of key terpenes like Myrcene, Pinene, etc., which helps define the strain's aroma and overall effect. **What information does `get_oil_lab_data` provide for extracts?** This tool gives lab results specific to cannabis oils and concentrates. It provides cannabinoid levels, including THC and CBD percentages, which are unique details for non-flower products. **How do I find out what brands are in the database using `list_brands`?** Running `list_brands` gives you a comprehensive directory of every available cannabis producer. You must then use `get_brand` to pull specific details on any listed company. **If I don't know the exact name, how do I find strains using `search_strains`?** You can use keywords or desired effects in `search_strains`. The system matches your input text against strain names and descriptions to suggest relevant results.