Carl's Golfland MCP server for AI agents

Let Claude, ChatGPT or your own agent read Carl's Golfland: 4 typed functions through one MCP server. No Carl's Golfland API key needed.

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

Connect

Just Carl's Golfland

An MCP server for Carl's Golfland 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/carlsgolfland
Every site

One MCP server for Carl's Golfland 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 4
  • addToCartHands the shopper the entry-point link for a priced configuration plus the exact choices to select on Carl's Golfland's own product page.

    Arguments

    NameTypeRequired
    urlKeystringYes
    selectionsRecord<string, string>Yes

    Returns CglCartHandoff

    interface CglPriceResult {
      urlKey: string;
      sku: string;
      variantSku: string | null;   // null until every multi-choice group is picked
      stockStatus: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      price: number | null;
      priceFormatted: string | null;
      applied: { group: string; choice: string }[];
      missingGroups: string[];     // groups with >1 choice and no selection applied
      unmatched: string[];         // selections that didn't match a real group/choice
      unavailable: string | null;  // every group picked, but the store does not offer that combination now (sold out)
      handoffUrl: string;          // the product's entry page
    }
    
    interface CglCartHandoff {
      urlKey: string;
      sku: string;
      name: string;
      url: string;                 // the product page, Carl's Golfland publishes no query-param deep link
      applied: { group: string; choice: string }[];
      price: number | null;
      priceFormatted: string | null;
      stockStatus: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      missingGroups: string[];
      unmatched: string[];
      unavailable: string | null;  // same as CglPriceResult.unavailable
      checkout: CglCheckoutHandoff;
    }
    
    // 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 CglCheckoutHandoff {
      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/carlsgolfland/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carlsgolfland.addToCart("ping-g440-max-driver", {
      Hand: "Right",
      "Driver Loft": "9*",
      Shaft: "Mitsubishi Tensei 1K Black 65 Stiff"
    });
  • getProductReads one product's full configurable-option set (e.g. Hand, Driver Loft, Shaft) with every choice's real label and every real buildable variant's…

    Arguments

    NameTypeRequired
    urlKeystringYes

    Returns CglProduct

    interface CglOptionChoice { label: string; valueIndex: number }
    
    interface CglOption {
      groupLabel: string;          // "Hand", "Driver Loft", "Shaft", the real group name
      attributeCode: string;
      choices: CglOptionChoice[];
    }
    
    interface CglVariant {
      sku: string;
      stockStatus: string;  // the site's own labels, read the values off a result, never guess one from prose
      price: number;
      priceFormatted: string;
      selections: Record<string, number>; // attributeCode -> valueIndex
    }
    
    interface CglProduct {
      urlKey: string;
      sku: string;
      name: string;
      url: string;
      stockStatus: string;  // the site's own labels, read the values off a result, never guess one from prose
      basePrice: number;
      basePriceFormatted: string;
      options: CglOption[];
      variants: CglVariant[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carlsgolfland.getProduct("ping-g440-max-driver");
  • priceConfigurationResolves a specific configuration (a choice per option group, e.g. { Hand: "Right", "Driver Loft": "10.5*" }) against getProduct's live…

    Arguments

    NameTypeRequired
    urlKeystringYes
    selectionsRecord<string, string>Yes

    Returns CglPriceResult

    interface CglPriceResult {
      urlKey: string;
      sku: string;
      variantSku: string | null;   // null until every multi-choice group is picked
      stockStatus: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      price: number | null;
      priceFormatted: string | null;
      applied: { group: string; choice: string }[];
      missingGroups: string[];     // groups with >1 choice and no selection applied
      unmatched: string[];         // selections that didn't match a real group/choice
      unavailable: string | null;  // every group picked, but the store does not offer that combination now (sold out)
      handoffUrl: string;          // the product's entry page
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/carlsgolfland/priceConfiguration

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.carlsgolfland.priceConfiguration("ping-g440-max-driver", {
      Hand: "Right",
      "Driver Loft": "9*",
      Shaft: "Mitsubishi Tensei 1K Black 65 Stiff"
    });
  • searchProductsSearches Carl's Golfland's golf-equipment catalog by free text and returns each match's urlKey, SKU, name, entry URL, stock status and starting price.

    Arguments

    NameTypeRequired
    querystringYes

    Returns CglProductSummary[]

    // Carl's Golfland's OWN shapes, not a capability contract.
    interface CglProductSummary {
      urlKey: string;              // the key getProduct takes
      sku: string;
      name: string;
      url: string;
      stockStatus: string;         // "IN_STOCK" | "OUT_OF_STOCK"
      basePrice: number;
      basePriceFormatted: string;  // "$447.00"
    }

    HTTP endpoint

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

    Call it

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

Use it from code