cdes-mcp-server
Integrates with GitHub Copilot in VS Code to provide CDES cannabis data standard capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cdes-mcp-serverlist all CDES schemas"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: @jambonz/mcp-schema-server
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/healthOption 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-serverFor local stdio transport, configure your MCP client:
{
"mcpServers": {
"cdes": {
"command": "cdes-mcp-server",
"args": []
}
}
}Available Tools
Tool | Description |
| List all CDES v1 schemas with titles, descriptions, and required fields |
| Get the full JSON Schema document by name |
| Validate a data object against any CDES schema |
| Look up detailed terpene information by ID or name |
| Look up detailed cannabinoid information by ID or name |
| Get standardized WCAG 2.1 AA color for a terpene |
| List all terpenes with summary data |
| List all cannabinoids with summary data |
| Full-text search across all reference data |
| Comprehensive CDES standard overview |
Available Resources
URI | Description |
| Strain schema |
| Terpene Profile schema |
| Cannabinoid Profile schema |
| Terpene definition schema |
| Certificate of Analysis schema |
| User Rating schema (CX extension) |
| Rating Aggregate schema |
| Terpene reference library (10 terpenes) |
| Cannabinoid reference library (9 cannabinoids) |
| 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 statisticsValidate 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 specification and JSON schemas | |
Python SDK for CDES (Pydantic models) | |
Reference data (terpenes, cannabinoids) | |
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.
This server cannot be deployed
Maintenance
Related MCP Connectors
- UnifAPIOAuthcom.unifapi
Hosted MCP server for live public-data APIs and Skills for AI agents.
Read-only MyDankTank catalog, Journal, policy, and machine metadata service for adults 21+.
51Public, read-only MCP server for FarmNeural company facts, packages, and capabilities.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
Related MCP Servers
- AlicenseAqualityDmaintenanceExposes the Agentic Patterns Catalog as MCP resources and tools for AI coding agents to search, retrieve, and recommend patterns, recipes, frameworks, methodologies, and anti-patterns.12MIT
- AlicenseAqualityBmaintenanceThis server exposes jambonz verb schemas and developer documentation as MCP tools, enabling AI agents to query verb definitions, component types, callback payloads, and the full developer guide without needing local access to the schema files.412 npmMIT
- AlicenseCqualityCmaintenanceMCP server for retrieving clinical standard content from the CDISC Library, supporting controlled terminology, ADaM, SDTM, CDASH, SEND metadata, and search.317MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for querying versioned C2PA specification knowledge graphs, enabling AI agents to browse entity definitions, validation rules, and version diffs via natural language.3Apache 2.0