DecksDirect MCP server for AI agents
Let Claude, ChatGPT or your own agent read DecksDirect: 4 typed functions through one MCP server. No DecksDirect API key needed.
- Site
- decksdirect.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for DecksDirect 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/decksdirectOne MCP server for DecksDirect 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 DecksDirect's own product page.Arguments
Name Type Required urlKeystringYes selectionsRecord<string, string>Yes Returns
DdCartHandoffinterface DdCartHandoff { urlKey: string; sku: string; name: string; url: string; // the product page, DecksDirect 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[]; checkout: DdCheckoutHandoff; } // 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 DdCheckoutHandoff { 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/decksdirect/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.decksdirect.addToCart("trapease-3-composite-deck-screw-by-fastenmaster", { "Pack Size": "1050 pack", Color: "Beach Dune" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.decksdirect.addToCart("trapease-3-composite-deck-screw-by-fastenmaster", {"Pack Size": "1050 pack", "Color": "Beach Dune"}))curl -X POST https://api.bowmark.ai/v1/sites/decksdirect/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"trapease-3-composite-deck-screw-by-fastenmaster","selections":{"Pack Size":"1050 pack","Color":"Beach Dune"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.decksdirect.addToCart("trapease-3-composite-deck-screw-by-fastenmaster", { "Pack Size": "1050 pack", Color: "Beach Dune" });getProductReads one product's full configurable-option set (e.g. Pack Size, Color) with every choice's real label and every real buildable variant's exact…Arguments
Name Type Required urlKeystringYes Returns
DdProductinterface DdOptionChoice { label: string; valueIndex: number } interface DdOption { groupLabel: string; // "Pack Size", "Color", the real group name attributeCode: string; choices: DdOptionChoice[]; } interface DdVariant { 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 DdProduct { 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: DdOption[]; variants: DdVariant[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/decksdirect/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.decksdirect.getProduct("trapease-3-composite-deck-screw-by-fastenmaster");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.decksdirect.getProduct("trapease-3-composite-deck-screw-by-fastenmaster"))curl -X POST https://api.bowmark.ai/v1/sites/decksdirect/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"trapease-3-composite-deck-screw-by-fastenmaster"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.decksdirect.getProduct("trapease-3-composite-deck-screw-by-fastenmaster");priceConfigurationResolves a specific configuration (a choice per option group, e.g. { Color: "Havana Gold" }) against getProduct's live option/variant data and…Arguments
Name Type Required urlKeystringYes selectionsRecord<string, string>Yes Returns
DdPriceResultinterface DdPriceResult { 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 handoffUrl: string; // the product's entry page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/decksdirect/priceConfigurationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.decksdirect.priceConfiguration("trapease-3-composite-deck-screw-by-fastenmaster", { "Pack Size": "1050 pack", Color: "Beach Dune" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.decksdirect.priceConfiguration("trapease-3-composite-deck-screw-by-fastenmaster", {"Pack Size": "1050 pack", "Color": "Beach Dune"}))curl -X POST https://api.bowmark.ai/v1/sites/decksdirect/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlKey":"trapease-3-composite-deck-screw-by-fastenmaster","selections":{"Pack Size":"1050 pack","Color":"Beach Dune"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.decksdirect.priceConfiguration("trapease-3-composite-deck-screw-by-fastenmaster", { "Pack Size": "1050 pack", Color: "Beach Dune" });searchProductsSearches DecksDirect's decking/railing/hardware catalog by free text and returns each match's urlKey, SKU, name, entry URL, stock status and starting…Arguments
Name Type Required querystringYes Returns
DdProductSummary[]// DecksDirect's OWN shapes, not a capability contract. interface DdProductSummary { urlKey: string; // the key getProduct takes sku: string; name: string; url: string; stockStatus: string; // "IN_STOCK" | "OUT_OF_STOCK" basePrice: number; basePriceFormatted: string; // "$9.96" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/decksdirect/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.decksdirect.searchProducts("composite decking");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.decksdirect.searchProducts("composite decking"))curl -X POST https://api.bowmark.ai/v1/sites/decksdirect/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"composite decking"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.decksdirect.searchProducts("composite decking");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/decksdirect/<function> - OpenAPI
/v1/sites/decksdirect/openapi.json