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.
- Site
- grainger.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/graingerOne MCP server for Grainger 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.
checkStockChecks real fulfillment availability for one item (itemNumber or url, same as getProduct) at a caller-supplied zip (required, 5-digit US).Arguments
Name Type Required itemNumberstringGrainger's own catalog item number (4-12 letters/digits), e.g. "26K909".No urlstringFull product URL starting with https://www.grainger.com/product/.No zipstringRequired. 5-digit US ZIP to answer shipping and nearest-branch pickup for; there is no default.Yes quantitynumberUnits wanted, a positive integer.No Returns
graingerStockRowinterface 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/checkStockCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.grainger.checkStock({ itemNumber: "26K909", zip: "60601" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.grainger.checkStock({"itemNumber": "26K909", "zip": "60601"}))curl -X POST https://api.bowmark.ai/v1/sites/grainger/checkStock \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"itemNumber":"26K909","zip":"60601"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.grainger.checkStock({ itemNumber: "26K909", zip: "60601" });findBranchFinds nearby Grainger branch locations for a ZIP or address.Arguments
Name Type Required zipstring5-digit US ZIP, matched to branches by its first 3 digits (coarse regional match, not a radius search).No citystringCity name, case-insensitive, e.g. "Chicago".No statestringTwo-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/findBranchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.grainger.findBranch({ zip: "35222" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.grainger.findBranch({"zip": "35222"}))curl -X POST https://api.bowmark.ai/v1/sites/grainger/findBranch \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"zip":"35222"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.grainger.findBranch({ zip: "35222" });getProductReads one product page in full.Arguments
Name Type Required itemNumberstringGrainger's own catalog item number (4-12 letters/digits), e.g. "26K909".No urlstringFull product URL starting with https://www.grainger.com/product/.No Returns
graingerProductRowinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.grainger.getProduct({ itemNumber: "26K909" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.grainger.getProduct({"itemNumber": "26K909"}))curl -X POST https://api.bowmark.ai/v1/sites/grainger/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"itemNumber":"26K909"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.grainger.getProduct({ itemNumber: "26K909" });searchSearches Grainger's industrial MRO catalog by keyword, returning matching products.Arguments
Name Type Required querystringFree-text catalog query, e.g. "antistatic gloves".Yes Returns
graingerSearchRow[]interface graingerSearchRow { itemNumber: string; name: string; url: string; brand: string | null; price: { amount: number; currency: string; perUnit: string } | null; thumbnail: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/grainger/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.grainger.search({ query: "antistatic gloves" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.grainger.search({"query": "antistatic gloves"}))curl -X POST https://api.bowmark.ai/v1/sites/grainger/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"antistatic gloves"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.grainger.search({ query: "antistatic gloves" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/grainger/<function> - OpenAPI
/v1/sites/grainger/openapi.json