Liquid Death MCP server for AI agents

Let Claude, ChatGPT or your own agent read Liquid Death: 5 typed functions through one MCP server. No Liquid Death API key needed.

Functions
5
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Liquid Death

An MCP server for Liquid Death alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/liquiddeath
Every site

One MCP server for Liquid Death and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 5
  • addToCartBuilds a filled cart for the shopper to open.

    Arguments

    NameTypeRequired
    itemsLiquiddeathCartItem[]Yes
    interface LiquiddeathCartItem {
      handle: string;
      variantId?: string;
      variantTitle?: string;
      quantity?: number;
    }

    Returns LiquiddeathCart

    interface LiquiddeathCartLine {
      handle: string;
      productTitle: string;
      variantId: string;
      variantTitle: string;
      quantity: number;
      price: string;
      lineTotal: string;
      available: boolean;
    }
    
    interface LiquiddeathCart {
      lines: LiquiddeathCartLine[];
      subtotal: string;
      cartUrl: string;
      checkoutUrl: string;
      allAvailable: boolean;
      unavailable: string[];
      checkout: LiquiddeathCheckoutHandoff;
    }
    
    // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders.
    // Switch on `status`; a status you do not recognise means "show the person `url` and stop".
    interface LiquiddeathCheckoutHandoff {
      status: "ready_to_checkout" | "needs_login" | "unavailable";
      url: string;                       // the https page to open on the site
      urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page
      reason?: string;                   // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart
      detail?: string;                   // unavailable only: one sentence saying why
      account: { site: string; hint: string; signedInAs?: string };
      summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/liquiddeath/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.liquiddeath.addToCart([{ handle: "mountain-water-still" }]);
  • getCartReads a cart the shopper already has, by its id.

    Arguments

    NameTypeRequired
    cartIdstringYes

    Returns LiquiddeathLiveCart

    interface LiquiddeathLiveCartLine {
      lineId: string;
      variantId: string;
      title: string;
      quantity: number;
      unitPrice: string;
      lineTotal: string;
    }
    
    interface LiquiddeathLiveCart {
      id: string;
      lines: LiquiddeathLiveCartLine[];
      totalQuantity: number;
      subtotal: string;
      total: string;
      currency: string;
      checkoutUrl: string;
      expiresAt: string | null;
      checkout: LiquiddeathCheckoutHandoff;
    }
    
    // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders.
    // Switch on `status`; a status you do not recognise means "show the person `url` and stop".
    interface LiquiddeathCheckoutHandoff {
      status: "ready_to_checkout" | "needs_login" | "unavailable";
      url: string;                       // the https page to open on the site
      urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page
      reason?: string;                   // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart
      detail?: string;                   // unavailable only: one sentence saying why
      account: { site: string; hint: string; signedInAs?: string };
      summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/liquiddeath/getCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.liquiddeath.getCart("gid://shopify/Cart/Z212345?key=123456789");
  • getProductReads one product by handle.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns LiquiddeathProduct

    interface LiquiddeathVariant {
      id: string;
      title: string;
      price: string;
      compareAtPrice: string | null;
      sku: string | null;
      available: boolean;
      options: string[];
    }
    
    interface LiquiddeathProduct {
      handle: string;
      title: string;
      productType: string;
      vendor: string;
      url: string;
      optionNames: string[];
      variants: LiquiddeathVariant[];
      priceRange: { min: string; max: string } | null;
      inStock: boolean;
      tags: string[];
      descriptionHtml: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/liquiddeath/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.liquiddeath.getProduct("mountain-water-still");
  • listProductsLists products from the catalogue without a search term, supporting the same limit, type and stock filters as searchProducts.

    Arguments

    NameTypeRequired
    opts{ productType?: string; inStockOnly?: boolean; limit?: number }No

    Returns LiquiddeathProduct[]

    interface LiquiddeathVariant {
      id: string;
      title: string;
      price: string;
      compareAtPrice: string | null;
      sku: string | null;
      available: boolean;
      options: string[];
    }
    
    interface LiquiddeathProduct {
      handle: string;
      title: string;
      productType: string;
      vendor: string;
      url: string;
      optionNames: string[];
      variants: LiquiddeathVariant[];
      priceRange: { min: string; max: string } | null;
      inStock: boolean;
      tags: string[];
      descriptionHtml: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/liquiddeath/listProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.liquiddeath.listProducts({});
  • searchProductsSearches the live catalogue and returns matching products with their real variants, current prices and per-variant stock.

    Arguments

    NameTypeRequired
    querystringYes
    opts{ productType?: string; inStockOnly?: boolean; limit?: number }No

    Returns LiquiddeathProduct[]

    interface LiquiddeathVariant {
      id: string;
      title: string;
      price: string;
      compareAtPrice: string | null;
      sku: string | null;
      available: boolean;
      options: string[];
    }
    
    interface LiquiddeathProduct {
      handle: string;
      title: string;
      productType: string;
      vendor: string;
      url: string;
      optionNames: string[];
      variants: LiquiddeathVariant[];
      priceRange: { min: string; max: string } | null;
      inStock: boolean;
      tags: string[];
      descriptionHtml: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/liquiddeath/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.liquiddeath.searchProducts("water");

Use it from code