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.

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Acidni-LLC/cdes-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server