Grainger MCP server for AI agents

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

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

Connect

Just Grainger

An MCP server for Grainger 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/grainger
Every site

One MCP server for Grainger 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
  • checkStockChecks real fulfillment availability for one item (itemNumber or url, same as getProduct) at a caller-supplied zip (required, 5-digit US).

    Arguments

    NameTypeRequired
    itemNumberstring
    Grainger's own catalog item number (4-12 letters/digits), e.g. "26K909".
    No
    urlstring
    Full product URL starting with https://www.grainger.com/product/.
    No
    zipstring
    Required. 5-digit US ZIP to answer shipping and nearest-branch pickup for; there is no default.
    Yes
    quantitynumber
    Units wanted, a positive integer.
    No

    Returns graingerStockRow

    interface graingerStockRow {
      itemNumber: string;
      zip: string;
      quantity: number;
      shipping: { message: string | null; fulfillmentCode: string | null; availKey: string | null } | null;
      pickup: {
        message: string | null;
        fulfillmentCode: string | null;
        availKey: string | null;
        branch: {
          branchCode: string;
          city: string | null;
          address: { street: string | null; city: string | null; state: string | null; zip: string | null; country: string | null } | null;
          url: string | null;
        } | null;
      } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grainger/checkStock

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grainger.checkStock({ itemNumber: "26K909", zip: "60601" });
  • findBranchFinds nearby Grainger branch locations for a ZIP or address.

    Arguments

    NameTypeRequired
    zipstring
    5-digit US ZIP, matched to branches by its first 3 digits (coarse regional match, not a radius search).
    No
    citystring
    City name, case-insensitive, e.g. "Chicago".
    No
    statestring
    Two-letter code ("IL") or full state name ("Illinois"), case-insensitive.
    No

    Returns graingerBranchRow[]

    interface graingerBranchRow {
      branchNumber: string;
      name: string;
      url: string;
      address: { street: string; city: string; state: string; zip: string; country: string };
      phone: string | null;
      curbsidePickupAvailable: boolean;
      hours: { day: string; hours: string }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/grainger/findBranch

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grainger.findBranch({ zip: "35222" });
  • getProductReads one product page in full.

    Arguments

    NameTypeRequired
    itemNumberstring
    Grainger's own catalog item number (4-12 letters/digits), e.g. "26K909".
    No
    urlstring
    Full product URL starting with https://www.grainger.com/product/.
    No

    Returns graingerProductRow

    interface graingerProductRow {
      itemNumber: string;
      manufacturerModel: string | null;
      name: string;
      description: string | null;
      brand: string | null;
      url: string;
      images: string[];
      price: { amount: number; currency: string; perUnit: string } | null;
      specs: { name: string; value: string }[];
      availabilitySummary: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.grainger.getProduct({ itemNumber: "26K909" });

Use it from code