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

Just National Business Furniture

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/nationalbusinessfurniture
Every site

One 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/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 National Business Furniture's own product page.

    Arguments

    NameTypeRequired
    skustringYes
    selectionsRecord<string, string>Yes

    Returns NbfCartHandoff

    interface 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/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    skustringYes

    Returns NbfProduct

    interface 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/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    skustringYes
    selectionsRecord<string, string>Yes

    Returns NbfPriceResult

    interface 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/priceConfiguration

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchProducts

    Call it

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

Use it from code