ask_atlas

Use first for a plain question such as "does CBD help epilepsy", "where does THC act" or "what binds TRPV1": finds the compounds, conditions and receptors the question names in the atlas and answers only from those records: the evidence grade, the key findings with PubMed identifiers, the atlas pages, a not medical advice line and cite_as (title, url, licence, accessed date). When the question names nothing the atlas holds, it says so and suggests the closest names and tools. Educational reference, not medical advice. No doses.

read-only

Argument	Type	Description
question*	string	A plain question that names a compound, a condition or a receptor, for example "does CBD help epilepsy".

Input schema (JSON)

{
  "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
}

cite

A ready citation for one atlas record (compound, target or condition) or for the atlas 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).

read-only

Argument	Type	Description
id	string	A record id or name, for example "compound:cbd", "CB1" or "epilepsy". Leave out to cite the atlas.

Input schema (JSON)

{
  "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 the atlas."
    }
  },
  "additionalProperties": false
}

compare_compounds

Use for "THC versus CBD" and similar questions: 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 atlas comparison page when one exists. Educational reference, not medical advice. Not a ranking of which is better for anyone.

read-only

Argument	Type	Description
ids*	array	Two to four compound ids or names, for example ["thc", "cbd"].

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 4,
      "minItems": 2,
      "description": "Two to four compound ids or names, for example [\"thc\", \"cbd\"]."
    }
  },
  "additionalProperties": false
}

fetch

The full text of one atlas 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 atlas url. Educational reference, not medical advice. No doses.

read-only

Argument	Type	Description
id*	string	A record id from search, for example "compound:cbd".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 120,
      "description": "A record id from search, for example \"compound:cbd\"."
    }
  },
  "additionalProperties": false
}

find_studies

Use for "what is the evidence" and "which studies": the PubMed studies the atlas 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 atlas record it belongs to, plus the PubMed search behind each record. Doses are left out on purpose. Educational reference, not medical advice.

read-only

Argument	Type	Description
limit	integer	How many items to return, at most 50.
target	string	A target, for example "TRPV1".
compound	string	A compound id or name, for example "cbd".
condition	string	A condition, for example "epilepsy".

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "How many items to return, at most 50."
    },
    "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
}

get_changes

The latest releases of the atlas data files: the version to cite, which datasets changed, records added and removed, and where the dated copy of each release lives.

read-only

Argument	Type	Description
limit	integer	How many items to return, at most 20.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 3,
      "maximum": 20,
      "minimum": 1,
      "description": "How many items to return, at most 20."
    }
  },
  "additionalProperties": false
}

get_compound

Use for "what does THC, CBD or myrcene do in the body": the full record of one mapped compound by atlas 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. Educational reference, not medical advice. No doses.

read-only

Argument	Type	Description
id*	string	Atlas id ("thc", "bcp"), database id ("CDB000032"), name ("Beta-caryophyllene", "Thymol") or PubChem CID (16078 or "CID 16078").

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 120,
      "description": "Atlas id (\"thc\", \"bcp\"), database id (\"CDB000032\"), name (\"Beta-caryophyllene\", \"Thymol\") or PubChem CID (16078 or \"CID 16078\")."
    }
  },
  "additionalProperties": false
}

get_cultivar

Use for strain chemistry: one cultivar from the laboratory measurements the atlas uses (Cannabis Compound Database values, mg per gram of dry flower), by CCD id or name: every atlas 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.

read-only

Argument	Type	Description
id*	string	CCD cultivar id ("STRAIN0001") or name ("8-Ball Kush").

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 120,
      "description": "CCD cultivar id (\"STRAIN0001\") or name (\"8-Ball Kush\")."
    }
  },
  "additionalProperties": false
}

get_target

Use for receptor questions: 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. Educational reference, not medical advice.

read-only

Argument	Type	Description
id*	string	Target id, name or gene.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 120,
      "description": "Target id, name or gene."
    }
  },
  "additionalProperties": false
}

list_structures_for_target

Use for "where in the body": the atlas body 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. Educational reference, not medical advice.

read-only

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".

Input schema (JSON)

{
  "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
}

list_trials

Use for clinical trial questions: registered trials from the atlas 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 atlas 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.

read-only

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	Atlas compound id or name, for example "cbd".

Input schema (JSON)

{
  "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": "Atlas compound id or name, for example \"cbd\"."
    }
  },
  "additionalProperties": false
}

search

Search the whole GreenCycle Compound Atlas 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.

read-only

Argument	Type	Description
query*	string	Any name or words, for example "cannabidiol", "CB1", "myrcene", "epilepsy" or "chronic pain trial".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Any name or words, for example \"cannabidiol\", \"CB1\", \"myrcene\", \"epilepsy\" or \"chronic pain trial\"."
    }
  },
  "additionalProperties": false
}

search_compounds

Use for lists of cannabis compounds: find the compounds mapped onto the human body (curated atlas 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 atlas url. Use get_compound for one full record. Educational reference, not medical advice.

read-only

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 (atlas records with reviewed effects and grades) or database (compounds with a measured value at a placed target).

Input schema (JSON)

{
  "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 (atlas records with reviewed effects and grades) or database (compounds with a measured value at a placed target)."
    }
  },
  "additionalProperties": false
}

search_conditions

Use for "does cannabis help with ...": conditions on the atlas 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 atlas 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.

read-only

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.

Input schema (JSON)

{
  "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
}

GreenCycle Compound Atlas

Try it

ask_atlas Read-only

GreenCycle Compound Atlas

Try it

ask_atlas Read-only

Tools (14)