Skip to main content
Glama
Acidni-LLC

cdes-mcp-server

by Acidni-LLC

CDES MCP Server

Cannabis Data Exchange Standard — Model Context Protocol Server

License: Apache-2.0 Python 3.12+ MCP

A public MCP server that exposes the Cannabis Data Exchange Standard (CDES) v1 JSON schemas, reference data libraries, and validation tools to AI agents and MCP-compatible clients.

What is CDES?

The Cannabis Data Exchange Standard is an open-source data standard for the cannabis industry, providing:

  • 7 JSON Schemas — Strain, Terpene Profile, Cannabinoid Profile, Terpene, Certificate of Analysis (COA), Rating, Rating Aggregate

  • 3 Reference Data Sets — Terpene Library (10 terpenes), Cannabinoid Library (9 cannabinoids), Terpene Color Palette (30 WCAG 2.1 AA colors)

  • Validation Tools — Validate any cannabis data object against CDES schemas

Related MCP server: @jambonz/mcp-schema-server

Quick Start

The CDES MCP Server is hosted publicly at https://mcp.cdes.world — no installation needed.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cdes": {
      "url": "https://mcp.cdes.world/sse"
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project:

{
  "mcpServers": {
    "cdes": {
      "type": "sse",
      "url": "https://mcp.cdes.world/sse"
    }
  }
}

Cursor / Windsurf

{
  "mcpServers": {
    "cdes": {
      "url": "https://mcp.cdes.world/sse"
    }
  }
}

Health Check

curl https://mcp.cdes.world/health

Option 2: Run Locally (stdio)

Install from source for local/offline use:

git clone https://github.com/Acidni-LLC/cdes-mcp-server.git
cd cdes-mcp-server
pip install -e .
cdes-mcp-server

For local stdio transport, configure your MCP client:

{
  "mcpServers": {
    "cdes": {
      "command": "cdes-mcp-server",
      "args": []
    }
  }
}

Available Tools

Tool

Description

list_schemas

List all CDES v1 schemas with titles, descriptions, and required fields

get_schema

Get the full JSON Schema document by name

validate_data

Validate a data object against any CDES schema

get_terpene_info

Look up detailed terpene information by ID or name

get_cannabinoid_info

Look up detailed cannabinoid information by ID or name

lookup_terpene_color

Get standardized WCAG 2.1 AA color for a terpene

list_terpenes

List all terpenes with summary data

list_cannabinoids

List all cannabinoids with summary data

search_reference_data

Full-text search across all reference data

get_cdes_overview

Comprehensive CDES standard overview

Available Resources

URI

Description

cdes://schemas/v1/strain

Strain schema

cdes://schemas/v1/terpene-profile

Terpene Profile schema

cdes://schemas/v1/cannabinoid-profile

Cannabinoid Profile schema

cdes://schemas/v1/terpene

Terpene definition schema

cdes://schemas/v1/coa

Certificate of Analysis schema

cdes://schemas/v1/rating

User Rating schema (CX extension)

cdes://schemas/v1/rating-aggregate

Rating Aggregate schema

cdes://reference/terpene-library

Terpene reference library (10 terpenes)

cdes://reference/cannabinoid-library

Cannabinoid reference library (9 cannabinoids)

cdes://reference/terpene-colors

Terpene color palette (30 colors)

Example Interactions

List all schemas

> Use the CDES server to list all available schemas

The CDES standard includes 7 schemas:
1. Strain — cannabis strain definition with type, effects, flavors
2. Terpene Profile — 21 named terpene measurements
3. Cannabinoid Profile — 13 cannabinoid measurements with computed totals
4. Terpene — individual terpene definition with CAS number, effects
5. COA — Certificate of Analysis with lab info, safety tests
6. Rating — user rating/review (CX extension)
7. Rating Aggregate — aggregated rating statistics

Validate data

> Validate this strain data against the CDES schema:
> {"id": "strain-001", "name": "Blue Dream", "type": "hybrid"}

✅ Valid! The data conforms to the CDES v1 strain schema.

Look up a terpene

> What is Myrcene? Use the CDES terpene library.

Myrcene (CAS: 123-35-3) is a monoterpene with an earthy, musky, herbal
aroma. It's the most common terpene in cannabis (~40% of strains).
Boiling point: 168°C. Key effects: relaxing, sedating, anti-inflammatory.
Found in mango, hops, lemongrass, and thyme.

Schema Structure

All schemas follow JSON Schema Draft 2020-12 with base URI:

https://schemas.terprint.com/cdes/v1/

Schema Relationships

strain.json
├── $ref → terpene-profile.json
├── $ref → cannabinoid-profile.json
└── enums: type, effects, flavors, difficulty

coa.json
├── $ref → terpene-profile.json
├── $ref → cannabinoid-profile.json
└── safetyTests: microbials, pesticides, heavyMetals, ...

terpene-profile.json
└── $defs/terpeneValue: number | {value, loq, lod, ...}

rating.json → rating-aggregate.json (computed)

Reference Data Licensing

Data Set

License

Description

Terpene Library

CC0-1.0

10 common cannabis terpenes with full metadata

Cannabinoid Library

CC0-1.0

9 cannabinoids with colors, effects, CAS numbers

Terpene Colors

CC0-1.0

30 WCAG 2.1 AA-compliant visualization colors

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/
ruff format src/

Project

Description

cdes-spec

CDES specification and JSON schemas

cdes-sdk-python

Python SDK for CDES (Pydantic models)

cdes-reference-data

Reference data (terpenes, cannabinoids)

cdes.world

CDES documentation website

License


Built by Acidni LLC — Powering the cannabis data ecosystem.

Related MCP Connectors

Related MCP Servers