MCP Server Setup

Connect cannabis market data directly to AI assistants using the CannMenus MCP server.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants access external data sources and tools. The CannMenus MCP server gives AI tools direct access to cannabis product data, brand analytics, pricing, stock status, and more — without writing any code.

Prerequisites

• A CannMenus Pro or API subscription
• An active API token (generate one from your API Dashboard)
• An MCP-compatible AI client (Claude, Cursor, Windsurf, etc.)

Setup

Claude Desktop

Add the following to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cannmenus": {
      "type": "url",
      "url": "https://api.cannmenus.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code (CLI)

Add to your project or global settings at .claude/settings.json:

{
  "mcpServers": {
    "cannmenus": {
      "type": "url",
      "url": "https://api.cannmenus.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude.ai (Web)

Claude.ai supports OAuth authentication. Simply add https://api.cannmenus.com/mcp/ as the URL — no token needed. You'll be redirected to log in and authorize access.

Step 1. Click your profile icon in the bottom-left corner, then click Settings.

Step 2. In the Settings sidebar, click Connectors.

Step 3. Click the + button and select Add custom connector.

Step 4. In the dialog, enter CannMenus as the name and paste the MCP server URL:

https://api.cannmenus.com/mcp/

Click Add. You'll be redirected to CannMenus to log in and authorize access.

Step 5. Once connected, CannMenus will appear in your connectors list and all tools will be available to Claude.

You can manage tool permissions from the Customize > Connectors page:

Cursor

Open Settings > MCP Servers and add a new server:

{
  "name": "cannmenus",
  "type": "url",
  "url": "https://api.cannmenus.com/mcp/",
  "headers": {
    "Authorization": "Bearer YOUR_API_TOKEN"
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "cannmenus": {
      "serverUrl": "https://api.cannmenus.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client that supports the Streamable HTTP transport can connect. Use:

• Server URL: https://api.cannmenus.com/mcp/
• Authentication: Pass your API token via Authorization: Bearer YOUR_API_TOKEN header or append ?token=YOUR_API_TOKEN as a query parameter

Available Tools

The MCP server provides 30 tools for querying cannabis market data, organized by category:

Product Discovery & Menu Analysis

Sales & Market Analytics

Brand Intelligence

Company & MSO Analysis

Wholesale (requires WholeSync subscription)

Bev/Alc Retail Analytics (requires subscription)

Reference Resources

The MCP server also exposes reference resources that help AI assistants discover valid parameter values:

Usage and Billing

Each MCP tool call makes one or more API requests on your behalf. These requests count toward your normal API usage and billing tiers:

Monitor your usage on the API Dashboard. Per-token request counts and last-used dates are displayed so you can track MCP usage separately from direct API calls.

Example Conversations

Once connected, you can ask your AI assistant questions like:

• "What are the best-selling flower brands in California?"
• "Compare pricing for Jeeter products across dispensaries in Colorado"
• "Which dispensaries in Arizona don't carry Raw Garden but carry similar brands?"
• "Show me market trends for edibles in Michigan"
• "Find the top 10 products by estimated sales in Oregon"

The AI assistant will automatically use the appropriate CannMenus tools to fetch real-time data and provide analysis.

Troubleshooting

"Authentication failed" — Verify your API token is active and correctly set in the Authorization: Bearer header (or ?token= query parameter). Generate a new token from the API Dashboard if needed.

"No results found" — Make sure you're using valid state codes and category names. Use the reference resources to discover valid values.

"Rate limited" — The MCP server respects standard API rate limits. If you're making many rapid queries, space them out or contact support for higher limits.