API Reference

GrowWise API Documentation

Stripe-modeled REST API with real cannabis dispensary data. Bearer token authentication, paginated responses, and MCP protocol support.

Getting Started

Make your first API call in 30 seconds.

bash
# Fetch all inventory (no auth required for public endpoints)
curl https://growwise-jet.vercel.app/api/v1/inventory

# Fetch with authentication
curl https://growwise-jet.vercel.app/api/v1/inventory \
  -H "Authorization: Bearer gw_your_api_key"

# Get platform stats
curl https://growwise-jet.vercel.app/api/v1/stats

API Endpoints

Four endpoint categories covering inventory, locations, stats, and AI protocol.

Inventory
Real product data from 30 South Dakota dispensaries. Search, filter, and paginate.
GET/api/v1/inventoryList all products (paginated)
GET/api/v1/inventory/:idGet product by ID
Locations
Dispensary locations with addresses, coordinates, and operating hours.
GET/api/v1/locationsList all locations
Stats
Platform-wide statistics including product counts, location counts, and strain data.
GET/api/v1/statsPlatform statistics
MCP Protocol
Model Context Protocol endpoint for AI agent integrations. Claude Desktop, Cursor, and custom agents.
POST/api/mcpMCP server endpoint

Authentication

GrowWise uses Bearer token authentication. Include your API key in the Authorization header of each request.

Public endpoints (inventory listing, stats) are accessible without authentication for demo purposes. Authenticated endpoints provide access to management features, write operations, and higher rate limits.

Authorization: Bearer
gw_your_api_key_here

Rate Limits

Rate limits are applied per API key to ensure fair usage and platform stability.

Public (no auth)60 req/min
Authenticated300 req/min
MCP Protocol120 req/min

MCP Protocol Support

GrowWise is MCP-native. Connect any AI agent — Claude Desktop, Cursor, or your custom agents — directly to your dispensary data. The MCP endpoint exposes 14 tools, 5 resources, and 5 prompts for AI-to-AI communication.

MCP Endpoint: https://growwise-jet.vercel.app/api/mcp