AI Agents

Connect Wine Labs to Claude, Cursor, Windsurf, and ChatGPT

Run matching, markets, auctions, exchange, listing, and agent-upload workflows through one MCP endpoint, with the same Wine Labs authorization and usage tracking underneath.

Download Install PackAPI Docs

Transport

Remote MCP

Auth

OAuth 2.1 + legacy bearer

Usage

Shared with your API plan

Quick connect

MCP endpoint

Paste this plain URL. Supported clients open Wine Labs sign-in automatically.

https://chat.wine-labs.com/mcp

Legacy connector URL

Optional fallback for an existing connector that does not support OAuth.

https://chat.wine-labs.com/mcp?access_token=YOUR_USER_ID_UUID&user_id=YOUR_USER_ID_UUID

Legacy auth header

Authorization: Bearer YOUR_USER_ID_UUID

Install Templates

Choose the client your team already uses

Start with the plain MCP URL. OAuth-capable clients discover Wine Labs sign-in and consent automatically; existing UUID configurations still work.

Claude Desktop

HTTP transport template for Claude.

Download File

Cursor

Drop into your MCP servers config.

Download File

Windsurf

Use the same HTTP MCP template.

Download File

ChatGPT

Connector-ready MCP template.

Download File

Claude Desktop MCP Template

{
  "mcpServers": {
    "winelabs": {
      "transport": "http",
      "url": "https://chat.wine-labs.com/mcp"
    }
  }
}

Data Access

Use `fetch_winelabs_data` for a single route, or `fetch_winelabs_data_bundle` when your workflow needs multiple endpoints in one pass.

Agent Uploads

Upload `price_list`, `sales_list`, `inventory`, `orders`, and `product_codes` through `/agent/upload_data` with base64 payloads.

Cellar Pricer

Submit cellar files and poll `/agent/cellar_pricer/submit`, `/status`, and `/jobs` from the same connected client.

Bundle Example

{
  "calls": [
    {
      "endpoint": "/listings",
      "body": {
        "query": "Chateau Margaux 2015",
        "currency": "USD"
      }
    },
    {
      "endpoint": "/agent/upload_data",
      "body": {
        "dataset_type": "orders",
        "filename": "orders.csv",
        "file_content_base64": "<BASE64_FILE_CONTENT>",
        "currency_code": "USD"
      }
    },
    {
      "endpoint": "/agent/cellar_pricer/submit",
      "body": {
        "filename": "cellar.csv",
        "file_content_base64": "<BASE64_FILE_CONTENT>",
        "currency_hint": "USD"
      }
    }
  ]
}

Authorization and Usage

MCP requests use the same authorization checks, quotas, and billing rules as the standard API.

Market data routes count against your API quota.

Cellar pricer routes count against your cellar row quota.

Agent uploads and checks stay scoped to the authenticated user.

OAuth tokens resolve to the same Wine Labs account and are never passed through to another service.

View endpoint docs