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

Bearer token

Usage

Shared with your API plan

Quick connect

MCP endpoint

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

Claude connector URL

Paste into Claude's Remote MCP server URL field.

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

Auth header

Authorization: Bearer YOUR_USER_ID_UUID

Install Templates

Choose the client your team already uses

Start with a ready-made MCP template, then copy the exact config into Claude Desktop, Cursor, Windsurf, or ChatGPT.

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",
      "headers": {
        "Authorization": "Bearer YOUR_USER_ID_UUID"
      }
    }
  }
}

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.

View endpoint docs