Read-only cannabis compound, receptor, body map and study data, every value sourced.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use when you have a plain question such as "does CBD help epilepsy", "where does THC act" or "what binds TRPV1": the best first call, one argument. It finds the compounds, conditions and receptors the question names in Greencyclepedia and answers only from those records: the evidence grade, the key findings with PubMed identifiers, the Greencyclepedia pages, a not medical advice line and cite_as (title, url, licence, accessed date). When the question names nothing Greencyclepedia holds, it says so and suggests the closest names and tools. Educational reference, not medical advice. No doses. Example arguments: {"question":"does CBD help epilepsy"}.
A plain question that names a compound, a condition or a receptor, for example "does CBD help epilepsy".
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://greencyclepedia.com/mcp
Use when you have a plain question such as "does CBD help epilepsy", "where does THC act" or "what binds TRPV1": the best first call, one argument. It finds the compounds, conditions and receptors the question names in Greencyclepedia and answers only from those records: the evidence grade, the key findings with PubMed identifiers, the Greencyclepedia pages, a not medical advice line and cite_as (title, url, licence, accessed date). When the question names nothing Greencyclepedia holds, it says so and suggests the closest names and tools. Educational reference, not medical advice. No doses. Example arguments: {"question":"does CBD help epilepsy"}.
| Argument | Type | Description |
|---|---|---|
| question* | string | A plain question that names a compound, a condition or a receptor, for example "does CBD help epilepsy". |
{
"type": "object",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 300,
"description": "A plain question that names a compound, a condition or a receptor, for example \"does CBD help epilepsy\"."
}
},
"additionalProperties": false
}Use when you hold one sentence about cannabis and want to know what evidence our records hold behind it, for example "CBD helps with epilepsy" or "beta-caryophyllene reduces inflammation". It finds the compounds, conditions and receptors the sentence names and returns the records it matched, the studies in our records counted by kind (human trial, human observational, animal, cell, review) with the best five and their citations, and one plain level made from the counts alone: human trials found, human studies without trials, only animal or cell studies, or no studies in our records. It never says a sentence is true, safe or effective. A product or strain is refused, and an amount in the sentence is removed, never judged. Educational reference, not medical advice. No doses. Example arguments: {"claim":"CBD helps with epilepsy"}.
| Argument | Type | Description |
|---|---|---|
| claim* | string | One sentence that names a compound, a condition or a receptor, in English or German, for example "CBD helps with epilepsy" or "Myrcen macht müde". |
{
"type": "object",
"required": [
"claim"
],
"properties": {
"claim": {
"type": "string",
"maxLength": 300,
"description": "One sentence that names a compound, a condition or a receptor, in English or German, for example \"CBD helps with epilepsy\" or \"Myrcen macht müde\"."
}
},
"additionalProperties": false
}Use when you are about to quote or link Greencyclepedia and need the citation. A ready citation for one Greencyclepedia record (compound, target or condition) or for Greencyclepedia as a whole: the canonical url, the citation line, a BibTeX entry, the version, the original papers to cite for its findings (PubMed links) and the licence (CC BY 4.0 with attribution). Example arguments: {"id":"compound:cbd"}.
| Argument | Type | Description |
|---|---|---|
| id | string | A record id or name, for example "compound:cbd", "CB1" or "epilepsy". Leave out to cite Greencyclepedia. |
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "A record id or name, for example \"compound:cbd\", \"CB1\" or \"epilepsy\". Leave out to cite Greencyclepedia."
}
},
"additionalProperties": false
}Use when asked "THC versus CBD" or a similar comparison. Two to four compounds side by side, target by target, with each action, evidence grade, measured binding values and PubMed identifiers, the targets they share and the Greencyclepedia comparison page when one exists. Educational reference, not medical advice. Not a ranking of which is better for anyone. Example arguments: {"ids":["thc","cbd"]}.
| Argument | Type | Description |
|---|---|---|
| ids | array | 2 to 4 compound ids or names, for example ["thc", "cbd"]; fewer or more get a helpful answer, not an error. |
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 4,
"description": "2 to 4 compound ids or names, for example [\"thc\", \"cbd\"]; fewer or more get a helpful answer, not an error."
}
},
"additionalProperties": false
}Use when search has returned an id and you want the whole record. The full text of one Greencyclepedia record by the id that search returned ("compound:cbd", "target:CB1", "condition:epilepsy", "trial:NCT03883360", "cultivar:STRAIN0001"): what it is, the targets and effects with evidence grades, measured binding values, cautions, every source (PubMed ids with links) and the citation line, with the Greencyclepedia url. Educational reference, not medical advice. No doses. Example arguments: {"id":"compound:cbd"}.
| Argument | Type | Description |
|---|---|---|
| id* | string | A record id from search, for example "compound:cbd". |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "A record id from search, for example \"compound:cbd\"."
}
},
"additionalProperties": false
}Use when asked "what is the evidence" or "which studies". The PubMed studies Greencyclepedia cites for a compound, a target, a condition or a compound at one target, each with its PubMed link, what it supports (an effect at a target, a binding value, a caution, a systematic review or a trial as administered) and the Greencyclepedia record it belongs to, a quality label for each (how the study was done, a band from stronger to early, and the rule; sort strongest puts the strongest designs first), plus the PubMed search behind each record. Doses are left out on purpose. Educational reference, not medical advice. Example arguments: {"compound":"cbd","condition":"epilepsy"}.
| Argument | Type | Description |
|---|---|---|
| sort | string | relevance (default) or strongest (strongest study design first). |
| limit | integer | How many items to return, at most 50. |
| query | string | Or a plain phrase, for example "cbd epilepsy" or "studies on CB1": the compound, target and condition it names are used. |
| target | string | A target, for example "TRPV1". |
| compound | string | A compound id or name, for example "cbd". |
| condition | string | A condition, for example "epilepsy". |
{
"type": "object",
"properties": {
"sort": {
"enum": [
"relevance",
"strongest"
],
"type": "string",
"description": "relevance (default) or strongest (strongest study design first)."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "How many items to return, at most 50."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Or a plain phrase, for example \"cbd epilepsy\" or \"studies on CB1\": the compound, target and condition it names are used."
},
"target": {
"type": "string",
"maxLength": 120,
"description": "A target, for example \"TRPV1\"."
},
"compound": {
"type": "string",
"maxLength": 120,
"description": "A compound id or name, for example \"cbd\"."
},
"condition": {
"type": "string",
"maxLength": 120,
"description": "A condition, for example \"epilepsy\"."
}
},
"additionalProperties": false
}Use when you have the id or name of one brain region (from list_brain_regions) and want everything the saved data holds on it. One region in full: where it sits in the hierarchy and its parts, a plain description in English and German, every measured PET value, every RNA level of 12 receptors and enzymes with its band, the 0 to 4 teaching scale, studies that differ stated as such, the compounds and conditions Greencyclepedia lists for it, the PubMed study count, the gaps in plain words and every credit line (Human Protein Atlas CC BY 4.0, the published PET paper, Z-Anatomy CC BY-SA 4.0, PubMed counts). Measured, RNA and teaching values are labelled and never mixed; a part never inherits a value from its parent. Educational reference, not medical advice. No doses. Example arguments: {"id":"hippocampus"}.
| Argument | Type | Description |
|---|---|---|
| id* | string | A region id or name in English or German, for example "hippocampus", "amygdala" or "Hippocampus". |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "A region id or name in English or German, for example \"hippocampus\", \"amygdala\" or \"Hippocampus\"."
}
},
"additionalProperties": false
}Use when you need to know what is new or whether the data changed since you last looked. The latest releases of the Greencyclepedia data files: the version to cite, which datasets changed, records added and removed, and where the dated copy of each release lives, plus new_sources: the news sources and partners added in the last 30 days, with the date added and what each covers. Example arguments: {"limit":3}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 20. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 3,
"maximum": 20,
"minimum": 1,
"description": "How many items to return, at most 20."
}
},
"additionalProperties": false
}Use when asked "what does THC, CBD or myrcene do in the body". The full record of one mapped compound by Greencyclepedia id, Cannabis Compound Database id, name or PubChem CID. A curated record gives identity and structure identifiers, every target with the action, effect, evidence grade, body structures and PubMed identifiers, the measured binding values (pKi, pIC50, pEC50) from the IUPHAR/BPS Guide to PHARMACOLOGY, the cultivars a laboratory measured it in with their sources, an evidence summary, its cautions and a ready citation. A database compound gives its identity and every measured value at a placed target with its PubMed id or DOI. The view object links the 3D page, a still picture and a drawing of the compound. Educational reference, not medical advice. No doses. Example arguments: {"id":"cbd"}.
| Argument | Type | Description |
|---|---|---|
| id* | string | Greencyclepedia id ("thc", "bcp"), database id ("CDB000032"), name ("Beta-caryophyllene", "Thymol") or PubChem CID (16078 or "CID 16078"). |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "Greencyclepedia id (\"thc\", \"bcp\"), database id (\"CDB000032\"), name (\"Beta-caryophyllene\", \"Thymol\") or PubChem CID (16078 or \"CID 16078\")."
}
},
"additionalProperties": false
}Use when asked about the chemistry of a strain or cultivar. One cultivar from the laboratory measurements Greencyclepedia uses (Cannabis Compound Database values, mg per gram of dry flower), by CCD id or name: every Greencyclepedia compound measured in it with the mean, the number of values and the PubMed identifier of each source. Cultivar names are a poor guide to chemistry (PMID 35588111, PMID 39137353); never the community strain index. Educational reference, not medical advice. Example arguments: {"id":"STRAIN0001"}.
| Argument | Type | Description |
|---|---|---|
| id* | string | CCD cultivar id ("STRAIN0001") or name ("8-Ball Kush"). |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "CCD cultivar id (\"STRAIN0001\") or name (\"8-Ball Kush\")."
}
},
"additionalProperties": false
}Use when asked how pain, a burn, chili heat, menthol cool or touch is felt, where a pain signal travels, or which receptors and brain parts are on the way. The route from the index fingertip to the brain in 8 stops (skin receptor, nerve fibre, dorsal root ganglion, spinal dorsal horn, spinothalamic tract, thalamus, cortex and the descending control from the periaqueductal gray), for one stimulus (heat, capsaicin, irritant, cool or touch) or all. Each stop gives its body structures (Greencyclepedia and Z-Anatomy, CC BY-SA 4.0), receptors with measured RNA where one exists (Human Protein Atlas, CC BY 4.0; RNA, not protein), a plain line in English or German, a verdict, the evidence rungs (people, animals, cells, proposed only) with species and the PubMed studies, each labelled by how it was done, the line where studies differ, and the actions of compounds (capsaicin, menthol, mustard oil, THC, CBD, CB2 and NK1 drug classes) with the studies that support, differ or find no clear effect. Gaps and what not to claim come back as such; a stop no study was read for is anatomy only. Illustration of published research, never a diagnosis, dose or treatment advice. Educational reference, not medical advice. No doses. Example arguments: {"stimulus":"capsaicin","site":"fingertip"}.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language of the plain lines: en or de. |
| site | string | Where on the body. Only the index fingertip route is saved, and it is the default; another place gets a note. |
| stimulus | string | What starts the signal: heat, capsaicin, irritant, cool or touch (chili, mustard, menthol and pressure also work). Leave out for every stimulus; an unknown one gets the whole route and a note. |
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"de"
],
"type": "string",
"default": "en",
"description": "Language of the plain lines: en or de."
},
"site": {
"type": "string",
"maxLength": 40,
"description": "Where on the body. Only the index fingertip route is saved, and it is the default; another place gets a note."
},
"stimulus": {
"type": "string",
"maxLength": 40,
"description": "What starts the signal: heat, capsaicin, irritant, cool or touch (chili, mustard, menthol and pressure also work). Leave out for every stimulus; an unknown one gets the whole route and a note."
}
},
"additionalProperties": false
}Use when asked about a receptor, channel or enzyme. One receptor, ion channel or enzyme by name or gene (for example CB1, CNR1, TRPV1, GPR55, FAAH, CYP3A4): what it is, where it sits in the body, the compounds mapped to it with their action, effect and evidence grade, and every measured binding or functional value with species and PubMed identifiers, plus the measured 3D structure (the PDB entry, method, resolution, organism, paper, licence, a viewer link and a still picture) or "No measured structure yet". Educational reference, not medical advice. Example arguments: {"id":"CB1"}.
| Argument | Type | Description |
|---|---|---|
| id* | string | Target id, name or gene. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 120,
"description": "Target id, name or gene."
}
},
"additionalProperties": false
}Use when asked where in the brain a receptor sits or a condition is linked, which brain regions have the most CB1, or what the parts of a region are. Lists brain regions (divisions, regions, sub-regions) in the order of the hierarchy, by name, by studies, by RNA level or by PET binding, with three kinds of value kept apart for one receptor (CB1 unless you name another): measured PET binding in living people (8 regions, one study), RNA level from the Human Protein Atlas (RNA, not protein; partOf true means the value is for a larger region), and a 0 to 4 teaching scale (a summary, not a measurement). Filter by query, parent (its direct parts), receptor or condition. Gaps come back as gaps. Studies differ on how daily cannabis use changes CB1; get_brain_region says where. Sources: Human Protein Atlas (CC BY 4.0), Terry et al. 2009 (PMID 19573609), PubMed counts, Z-Anatomy (CC BY-SA 4.0). Educational reference, not medical advice. No doses. Example arguments: {"receptor":"CB1","sort":"pet","limit":5}.
| Argument | Type | Description |
|---|---|---|
| sort | string | hierarchy (the order of the file), name, studies (most PubMed studies first), rna (highest RNA level of the receptor first) or pet (highest measured binding first). |
| limit | integer | How many items to return, at most 60. |
| query | string | Part of a region name in English or German, or its id, for example "amygdala" or "Hippocampus". |
| parent | string | A region id or name: only its direct parts are listed, for example "amygdala" or "cerebral_cortex". |
| receptor | string | A receptor, channel or enzyme with a value in the brain regions, for example CB1, CB2, TRPV1, FAAH or 5-HT1A (its gene name also works). Regions with no value for it are left out and counted. |
| condition | string | A condition id or name, for example epilepsy: only regions whose record lists it (10 regions have conditions). |
{
"type": "object",
"properties": {
"sort": {
"enum": [
"hierarchy",
"name",
"studies",
"rna",
"pet"
],
"type": "string",
"default": "hierarchy",
"description": "hierarchy (the order of the file), name, studies (most PubMed studies first), rna (highest RNA level of the receptor first) or pet (highest measured binding first)."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 60,
"minimum": 1,
"description": "How many items to return, at most 60."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Part of a region name in English or German, or its id, for example \"amygdala\" or \"Hippocampus\"."
},
"parent": {
"type": "string",
"maxLength": 120,
"description": "A region id or name: only its direct parts are listed, for example \"amygdala\" or \"cerebral_cortex\"."
},
"receptor": {
"type": "string",
"maxLength": 40,
"description": "A receptor, channel or enzyme with a value in the brain regions, for example CB1, CB2, TRPV1, FAAH or 5-HT1A (its gene name also works). Regions with no value for it are left out and counted."
},
"condition": {
"type": "string",
"maxLength": 60,
"description": "A condition id or name, for example epilepsy: only regions whose record lists it (10 regions have conditions)."
}
},
"additionalProperties": false
}Use when asked what cannabis research was published or entered in PubMed lately, or whether a new study exists on a topic. The newest cannabis, cannabinoid, cannabidiol and THC studies from PubMed, by PubMed entry date, newest first, each sorted by kind of evidence (people, animals, cells, review, other) with the rule that decided it, and matched to the Greencyclepedia compounds, conditions and body parts. Every study carries a quality label (how it was done, a band from stronger to early, and the rule); sort strongest puts the strongest designs first. A study in animals or cells always says so in note. Filter by since (entry date), kind, topic, compound, condition or no_home. Source: PubMed (National Library of Medicine), with PMID links. Titles only, no abstracts, no doses. Educational reference, not medical advice. Example arguments: {"kind":"animals","limit":5}.
| Argument | Type | Description |
|---|---|---|
| kind | string | Kind of evidence: people, animals, cells, review or other. |
| sort | string | relevance (default, newest first) or strongest (strongest study design first). |
| limit | integer | How many items to return, at most 50. |
| since | string | Only studies entered in PubMed on or after this date, YYYY-MM-DD. |
| topic | string | A word from the study topics, for example obesity. |
| no_home | boolean | true: only studies that match no Greencyclepedia condition. |
| compound | string | A Greencyclepedia compound id or name, for example cbd or THC. |
| condition | string | A Greencyclepedia condition id, for example epilepsy. |
{
"type": "object",
"properties": {
"kind": {
"enum": [
"people",
"animals",
"cells",
"review",
"other"
],
"type": "string",
"description": "Kind of evidence: people, animals, cells, review or other."
},
"sort": {
"enum": [
"relevance",
"strongest"
],
"type": "string",
"description": "relevance (default, newest first) or strongest (strongest study design first)."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "How many items to return, at most 50."
},
"since": {
"type": "string",
"maxLength": 10,
"description": "Only studies entered in PubMed on or after this date, YYYY-MM-DD."
},
"topic": {
"type": "string",
"maxLength": 80,
"description": "A word from the study topics, for example obesity."
},
"no_home": {
"type": "boolean",
"description": "true: only studies that match no Greencyclepedia condition."
},
"compound": {
"type": "string",
"maxLength": 80,
"description": "A Greencyclepedia compound id or name, for example cbd or THC."
},
"condition": {
"type": "string",
"maxLength": 80,
"description": "A Greencyclepedia condition id, for example epilepsy."
}
},
"additionalProperties": false
}Use when asked "where in the body". The body map structures (organs and regions) that carry a molecular target: for CB1 and CB2 the qualitative receptor density (0 to 4, a teaching summary of the literature, not a measurement), other receptors listed for a structure, and the structures where a compound effect at this target is mapped, with the compound and its evidence grade, and the measured 3D structure of the target (entry, method, resolution, organism, paper, licence, viewer link, still picture) or "No measured structure yet". Educational reference, not medical advice. Example arguments: {"target":"CB1"}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 99. |
| target* | string | Target id, name or gene, for example "CB1" or "TRPV1". |
{
"type": "object",
"required": [
"target"
],
"properties": {
"limit": {
"type": "integer",
"default": 40,
"maximum": 99,
"minimum": 1,
"description": "How many items to return, at most 99."
},
"target": {
"type": "string",
"maxLength": 120,
"description": "Target id, name or gene, for example \"CB1\" or \"TRPV1\"."
}
},
"additionalProperties": false
}Use when asked which new cannabis research topics Greencyclepedia does not cover yet. Topics (for example obesity) with new cannabis studies in PubMed that no Greencyclepedia condition covers, most studies first, with the kinds of evidence behind each and the PMID links. Educational reference, not medical advice. No doses. Example arguments: {"limit":5}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 50. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "How many items to return, at most 50."
}
},
"additionalProperties": false
}Use when asked about clinical trials. Registered trials from the Greencyclepedia snapshot of ClinicalTrials.gov (trials whose intervention is named cannabis, a cannabinoid, cannabidiol, THC or a related medicine): identifier, title, status, phase, enrolment, conditions, countries, start date, the Greencyclepedia compounds involved and the registry link, newest snapshot first. Intervention names that state an amount are left out. Titles are third party text. Educational reference, not medical advice. Example arguments: {"query":"epilepsy","limit":5}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 25. |
| phase | string | Phase as registered. |
| query | string | Words in the title, the conditions or the MeSH terms, for example "epilepsy" or "chronic pain". |
| offset | integer | Skip this many matching trials (for paging). |
| status | string | Overall status as registered. |
| compound | string | Greencyclepedia compound id or name, for example "cbd". |
| condition | string | Greencyclepedia condition id, name or other name, for example "cancer", "glioblastoma" or "sleep": the trials Greencyclepedia counts for that condition (only conditions with a tally; the answer says when there is none). |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "How many items to return, at most 25."
},
"phase": {
"enum": [
"EARLY_PHASE1",
"PHASE1",
"PHASE2",
"PHASE3",
"PHASE4",
"NA"
],
"type": "string",
"description": "Phase as registered."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Words in the title, the conditions or the MeSH terms, for example \"epilepsy\" or \"chronic pain\"."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 5000,
"minimum": 0,
"description": "Skip this many matching trials (for paging)."
},
"status": {
"enum": [
"RECRUITING",
"NOT_YET_RECRUITING",
"ENROLLING_BY_INVITATION",
"ACTIVE_NOT_RECRUITING",
"COMPLETED",
"TERMINATED",
"SUSPENDED",
"WITHDRAWN",
"UNKNOWN",
"AVAILABLE",
"NO_LONGER_AVAILABLE",
"APPROVED_FOR_MARKETING"
],
"type": "string",
"description": "Overall status as registered."
},
"compound": {
"type": "string",
"maxLength": 120,
"description": "Greencyclepedia compound id or name, for example \"cbd\"."
},
"condition": {
"type": "string",
"maxLength": 120,
"description": "Greencyclepedia condition id, name or other name, for example \"cancer\", \"glioblastoma\" or \"sleep\": the trials Greencyclepedia counts for that condition (only conditions with a tally; the answer says when there is none)."
}
},
"additionalProperties": false
}Use when you have several compound, terpene, receptor or condition names and want each checked in one call instead of one call per name. Send 1 to 20 names or ids; each answer comes back in the same order as a short record summary (id, kind, title, link, cite_as and a one line summary) or as a soft miss with a did-you-mean. One unknown name never fails the call; names after the 20th are left out with a note. Compounds, terpenes, receptors and conditions only: a product or strain together with a condition gets the soft refusal for that one name. Educational reference, not medical advice. No doses. Example arguments: {"names":["cbd","myrcene","CB1","epilepsy"]}.
| Argument | Type | Description |
|---|---|---|
| kind | string | Optional: only this kind counts as a match: compound, terpene, receptor or condition. |
| names* | array | Compound, terpene, receptor or condition names or ids, for example ["cbd", "myrcene", "CB1", "epilepsy"]. At most 20 are answered, in this order. |
{
"type": "object",
"required": [
"names"
],
"properties": {
"kind": {
"enum": [
"compound",
"terpene",
"receptor",
"condition"
],
"type": "string",
"description": "Optional: only this kind counts as a match: compound, terpene, receptor or condition."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"minItems": 1,
"description": "Compound, terpene, receptor or condition names or ids, for example [\"cbd\", \"myrcene\", \"CB1\", \"epilepsy\"]. At most 20 are answered, in this order."
}
},
"additionalProperties": false
}Use when asked about the cannabis market or industry figures. Facts from cannabis industry news in our own words, each with its number, the data source the article names (or "no source named") and a link to the publisher. Market context, not medical evidence. Newest article first; replaced figures are left out unless asked for. Example arguments: {"limit":5}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 50. |
| since | string | A day, YYYY-MM-DD: only signals from articles on or after it. |
| region | string | Only signals of this region, for example "de" or "eu". |
| include_replaced | boolean | True to include figures a newer signal replaced (history). |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "How many items to return, at most 50."
},
"since": {
"type": "string",
"maxLength": 10,
"description": "A day, YYYY-MM-DD: only signals from articles on or after it."
},
"region": {
"type": "string",
"maxLength": 20,
"description": "Only signals of this region, for example \"de\" or \"eu\"."
},
"include_replaced": {
"type": "boolean",
"default": false,
"description": "True to include figures a newer signal replaced (history)."
}
},
"additionalProperties": false
}Use when you do not know the exact name or id, or want to see what Greencyclepedia holds on a topic. Search all of Greencyclepedia by any name: cannabis compounds (THC, CBD, CBG, terpenes, flavonoids), receptors and enzymes (CB1, CB2, TRPV1, 5-HT1A, FAAH), medical conditions with an evidence grade (epilepsy, chronic pain, sleep) and registered clinical trials. Returns results with id, title and url; pass an id to fetch for the full sourced record. Educational reference, not medical advice. Example arguments: {"query":"cannabidiol"}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 20. |
| query | string | The main argument: any name or words (left out or blank, you get a helpful starter answer), for example "cannabidiol", "CB1", "myrcene", "epilepsy" or "chronic pain trial". |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 20,
"minimum": 1,
"description": "How many items to return, at most 20."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "The main argument: any name or words (left out or blank, you get a helpful starter answer), for example \"cannabidiol\", \"CB1\", \"myrcene\", \"epilepsy\" or \"chronic pain trial\"."
}
},
"additionalProperties": false
}Use when you need a list of cannabis compounds, for example every compound at CB2 or every terpene. Find the compounds mapped onto the human body (curated Greencyclepedia records and database compounds with a measured, sourced value at a target placed in tissue) by name, chemical class, record type or molecular target (for example every compound acting at CB2, TRPV1, 5-HT1A or FAAH, or every terpene). Returns identity, PubChem CID, record type, targets and the Greencyclepedia url. Use get_compound for one full record. Educational reference, not medical advice. Example arguments: {"target":"CB2","limit":10}.
| Argument | Type | Description |
|---|---|---|
| class | string | Chemical class. |
| limit | integer | How many items to return, at most 100. |
| query | string | Part of a name or identifier, for example "cannabidiol", "CBD", "thymol" or "CDB000032". Leave out to list all. |
| target | string | A receptor, channel or enzyme by name or gene, for example "CB2", "CNR1" or "PPAR-gamma". |
| recordType | string | curated (Greencyclepedia records with reviewed effects and grades) or database (compounds with a measured value at a placed target). |
{
"type": "object",
"properties": {
"class": {
"enum": [
"cannabinoid",
"terpene",
"flavonoid",
"metabolite",
"phenolic",
"fatty"
],
"type": "string",
"description": "Chemical class."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "How many items to return, at most 100."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Part of a name or identifier, for example \"cannabidiol\", \"CBD\", \"thymol\" or \"CDB000032\". Leave out to list all."
},
"target": {
"type": "string",
"maxLength": 120,
"description": "A receptor, channel or enzyme by name or gene, for example \"CB2\", \"CNR1\" or \"PPAR-gamma\"."
},
"recordType": {
"enum": [
"curated",
"database"
],
"type": "string",
"description": "curated (Greencyclepedia records with reviewed effects and grades) or database (compounds with a measured value at a placed target)."
}
},
"additionalProperties": false
}Use when asked "does cannabis help with ...". Conditions on the Greencyclepedia evidence ladder (substantial, moderate, limited, insufficient, evidence of no benefit): the grade and why, the systematic reviews and trials behind it by PubMed identifier, the compounds and body structures involved and the Greencyclepedia page. Trials are kept as administered in each trial; doses are left out on purpose. Educational reference, not medical advice. Not a diagnostic or dosing tool. Example arguments: {"query":"sleep"}.
| Argument | Type | Description |
|---|---|---|
| grade | string | Only conditions with this evidence grade. |
| query | string | Part of a condition name, for example "epilepsy", "pain" or "sleep". Leave out to list all. |
{
"type": "object",
"properties": {
"grade": {
"enum": [
"substantial",
"moderate",
"limited",
"insufficient",
"against"
],
"type": "string",
"description": "Only conditions with this evidence grade."
},
"query": {
"type": "string",
"maxLength": 120,
"description": "Part of a condition name, for example \"epilepsy\", \"pain\" or \"sleep\". Leave out to list all."
}
},
"additionalProperties": false
}Use when asked "how much research is there on the thorax" or "which body parts have no studies yet". The Studies per body part key of the Greencyclepedia body map. Give a region (head-neck, thorax, abdomen, pelvis, upper-limb-left, upper-limb-right, lower-limb-left, lower-limb-right) or leave it out for the whole body: the parts by study band (No studies yet, 1 to 99, 100 to 999, 1,000+) with counts, the most studied parts, the parts with no studies yet, the snapshot date, the source and licence and the body map link. A count is the PubMed studies that name the part, from a weekly saved snapshot. Educational reference, not medical advice. Example arguments: {"region":"thorax"}.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, at most 100. |
| region | string | A region id or name, for example "thorax", "head-neck" or "left leg", or "whole body". Leave out for the whole body. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "How many items to return, at most 100."
},
"region": {
"type": "string",
"maxLength": 120,
"description": "A region id or name, for example \"thorax\", \"head-neck\" or \"left leg\", or \"whole body\". Leave out for the whole body."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.