home / mcp / cola cloud mcp server

COLA Cloud MCP Server

Provides access to COLA label data from MCP-compatible AI tools via API keys and local runtimes.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cola-cloud-us-colacloud-mcp": {
      "command": "uvx",
      "args": [
        "colacloud-mcp"
      ],
      "env": {
        "COLA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can access COLA Cloud’s 2.5M+ COLA records directly from MCP-compatible AI tools. This server lets Claude, ChatGPT, and other MCP clients query the TTB label data to find, filter, and inspect alcohol label information, including images and extracted fields.

How to use

To use this MCP server, connect your MCP client and choose the colacloud MCP endpoint you configured. You can search for labels by brand, product type, origin, or dates; look up details for a specific COLA by its TTB ID; and retrieve related permittee information and barcodes. You’ll be able to see basic info (brand, product name, type, origin), dates (application, approval, expiration), label images, extracted fields (ABV, volume, barcodes), and AI-enriched data (category, tasting notes, descriptions). Use straightforward, natural language prompts to ask for labels, recent approvals, or barcode-based lookups, and your MCP client will return the corresponding records.”}]},{

Practical usage patterns include: asking for all Tito’s vodka labels, finding wine labels from Napa Valley approved in 2024, looking up a product by its barcode, retrieving recent labels from a specific permittee, or filtering by beverage type and ABV range.

How to install

Prerequisites: you need a runtime to execute MCP endpoints. The recommended option is uvx, which requires no separate installation. You can also install the server via Python’s package manager if you prefer.

# Using uvx (recommended, no install required)
uvx colacloud-mcp

# Or install with pip
pip install colacloud-mcp

Configuration

Configure your MCP client with your API key to access COLA Cloud data.

{
  "mcpServers": {
    "colacloud": {
      "command": "uvx",
      "args": ["colacloud-mcp"],
      "env": {
        "COLA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Getting an API Key

Follow these steps to obtain an API key you can use with the MCP server.

1. Create an account at app.colacloud.us
2. Go to Dashboard > API Keys
3. Create a new API key

Available tools

search_colas

Search and filter COLA records by brand, product type, origin, dates, ABV

get_cola

Get detailed info for a specific COLA by TTB ID

search_permittees

Search permit holders (alcohol producers/importers)

get_permittee

Get permit holder details with recent COLAs

lookup_barcode

Find COLAs by product barcode (UPC/EAN)

get_api_usage

Check your API usage and rate limits