National Business Furniture MCP server for AI agents
Let Claude, ChatGPT or your own agent read National Business Furniture: 4 typed functions through one MCP server. No National Business Furniture API key needed.
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for National Business Furniture 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/nationalbusinessfurnitureOne MCP server for National Business Furniture 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 National Business Furniture's own product page.Arguments
Name Type Required skustringYes selectionsRecord<string, string>Yes Returns
NbfCartHandoffinterface NbfCartHandoff { sku: string; name: string; url: string; // the product page, NBF publishes no query-param deep link, so this is the base URL applied: { group: string; choice: string }[]; price: number | null; priceFormatted: string | null; missingGroups: string[]; unmatched: string[]; checkout: NbfCheckoutHandoff; // the product page; the person picks the choices and presses Add to Cart. Bowmark never pays } // 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 NbfCheckoutHandoff { 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/nationalbusinessfurniture/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nationalbusinessfurniture.addToCart("227514", { Finish: "Ash Black" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nationalbusinessfurniture.addToCart("227514", {"Finish": "Ash Black"}))curl -X POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"227514","selections":{"Finish":"Ash Black"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nationalbusinessfurniture.addToCart("227514", { Finish: "Ash Black" });getProductReads one product's full configurable-option set (e.g. Finish) with every choice's real label, matching variant SKU and exact price, plus the base…Arguments
Name Type Required skustringYes Returns
NbfProductinterface NbfOptionChoice { valueIndex: number; label: string; variantSku: string; price: number; priceFormatted: string } // with 2+ groups: the cheapest variant carrying this choice interface NbfOption { groupLabel: string; // "Finish", the real swatch group name, not GraphQL's opaque attribute_code choices: NbfOptionChoice[]; } interface NbfProduct { sku: string; name: string; url: string; basePrice: number; basePriceFormatted: string; options: NbfOption[]; variants: { variantSku: string; price: number; priceFormatted: string; choices: Record<string, string> }[]; // e.g. choices { Top: "Black", Base: "White" } }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nationalbusinessfurniture.getProduct("227514");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nationalbusinessfurniture.getProduct("227514"))curl -X POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"227514"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nationalbusinessfurniture.getProduct("227514");priceConfigurationResolves a specific configuration (a choice per option group, e.g. { Finish: "Ash Black" }) against getProduct's live option data and returns the…Arguments
Name Type Required skustringYes selectionsRecord<string, string>Yes Returns
NbfPriceResultinterface NbfPriceResult { sku: string; variantSku: string | null; // null until every option group is picked price: number | null; priceFormatted: string | null; applied: { group: string; choice: string }[]; missingGroups: string[]; // option groups with no valid selection applied unmatched: string[]; // selections that didn't match a real group/choice, named so nothing mispriced silently handoffUrl: string; // the product's entry page, call addToCart for the same page plus which swatch to click }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/priceConfigurationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nationalbusinessfurniture.priceConfiguration("227514", { Finish: "Ash Black" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nationalbusinessfurniture.priceConfiguration("227514", {"Finish": "Ash Black"}))curl -X POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"227514","selections":{"Finish":"Ash Black"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nationalbusinessfurniture.priceConfiguration("227514", { Finish: "Ash Black" });searchProductsSearches National Business Furniture's office-furniture catalog by free text and returns each match's SKU, name, entry URL and starting price.Arguments
Name Type Required querystringYes Returns
NbfProductSummary[]// National Business Furniture's OWN shapes, not a capability contract. interface NbfProductSummary { sku: string; // the key getProduct takes name: string; urlKey: string; url: string; basePrice: number; basePriceFormatted: string; // "$1,969.00" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nationalbusinessfurniture.searchProducts("desk");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nationalbusinessfurniture.searchProducts("desk"))curl -X POST https://api.bowmark.ai/v1/sites/nationalbusinessfurniture/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"desk"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nationalbusinessfurniture.searchProducts("desk");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nationalbusinessfurniture/<function> - OpenAPI
/v1/sites/nationalbusinessfurniture/openapi.json