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
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/carlsgolflandOne 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/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.
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
Name Type Required urlKeystringYes selectionsRecord<string, string>Yes Returns
CglCartHandoffinterface 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/addToCartCall 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" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carlsgolfland.addToCart("ping-g440-max-driver", { "Hand": "Right", "Driver Loft": "9*", "Shaft": "Mitsubishi Tensei 1K Black 65 Stiff" }))curl -X POST https://api.bowmark.ai/v1/sites/carlsgolfland/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"ping-g440-max-driver","selections":{"Hand":"Right","Driver Loft":"9*","Shaft":"Mitsubishi Tensei 1K Black 65 Stiff"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlKeystringYes Returns
CglProductinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carlsgolfland.getProduct("ping-g440-max-driver");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carlsgolfland.getProduct("ping-g440-max-driver"))curl -X POST https://api.bowmark.ai/v1/sites/carlsgolfland/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"ping-g440-max-driver"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlKeystringYes selectionsRecord<string, string>Yes Returns
CglPriceResultinterface 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/priceConfigurationCall 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" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carlsgolfland.priceConfiguration("ping-g440-max-driver", { "Hand": "Right", "Driver Loft": "9*", "Shaft": "Mitsubishi Tensei 1K Black 65 Stiff" }))curl -X POST https://api.bowmark.ai/v1/sites/carlsgolfland/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"ping-g440-max-driver","selections":{"Hand":"Right","Driver Loft":"9*","Shaft":"Mitsubishi Tensei 1K Black 65 Stiff"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carlsgolfland.searchProducts("driver");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carlsgolfland.searchProducts("driver"))curl -X POST https://api.bowmark.ai/v1/sites/carlsgolfland/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"driver"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carlsgolfland.searchProducts("driver");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/carlsgolfland/<function> - OpenAPI
/v1/sites/carlsgolfland/openapi.json