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.
- Site
- liquiddeath.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/liquiddeathOne 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/mcpSet it up in your clientBoth 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.
addToCartBuilds a filled cart for the shopper to open.Arguments
Name Type Required itemsLiquiddeathCartItem[]Yes interface LiquiddeathCartItem { handle: string; variantId?: string; variantTitle?: string; quantity?: number; }Returns
LiquiddeathCartinterface 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/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.liquiddeath.addToCart([{ handle: "mountain-water-still" }]);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.liquiddeath.addToCart([{"handle": "mountain-water-still"}]))curl -X POST https://api.bowmark.ai/v1/sites/liquiddeath/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"items":[{"handle":"mountain-water-still"}]}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.liquiddeath.addToCart([{ handle: "mountain-water-still" }]);getCartReads a cart the shopper already has, by its id.Arguments
Name Type Required cartIdstringYes Returns
LiquiddeathLiveCartinterface 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/getCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.liquiddeath.getCart("gid://shopify/Cart/Z212345?key=123456789");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.liquiddeath.getCart("gid://shopify/Cart/Z212345?key=123456789"))curl -X POST https://api.bowmark.ai/v1/sites/liquiddeath/getCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"cartId":"gid://shopify/Cart/Z212345?key=123456789"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.liquiddeath.getCart("gid://shopify/Cart/Z212345?key=123456789");getProductReads one product by handle.Arguments
Name Type Required handlestringYes Returns
LiquiddeathProductinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.liquiddeath.getProduct("mountain-water-still");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.liquiddeath.getProduct("mountain-water-still"))curl -X POST https://api.bowmark.ai/v1/sites/liquiddeath/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"mountain-water-still"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.liquiddeath.listProducts({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.liquiddeath.listProducts({}))curl -X POST https://api.bowmark.ai/v1/sites/liquiddeath/listProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"opts":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.liquiddeath.listProducts({});searchProductsSearches the live catalogue and returns matching products with their real variants, current prices and per-variant stock.Arguments
Name Type Required 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.liquiddeath.searchProducts("water");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.liquiddeath.searchProducts("water"))curl -X POST https://api.bowmark.ai/v1/sites/liquiddeath/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"water"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.liquiddeath.searchProducts("water");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/liquiddeath/<function> - OpenAPI
/v1/sites/liquiddeath/openapi.json