CDES MCP Server

Cannabis Data Exchange Standard — Model Context Protocol Server

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

Quick Start

Option 1: Use the Public Server (Recommended)

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/

Related Projects

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

• Code: Apache 2.0
• Schemas: CC BY 4.0
• Reference Data: CC0 1.0

---

Built by Acidni LLC — Powering the cannabis data ecosystem.