Ferguson MCP server for AI agents

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

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

Connect

Just Ferguson

An MCP server for Ferguson 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/ferguson
Every site

One MCP server for Ferguson 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 2
  • findBranchesLists Ferguson branch locations in a US state, optionally narrowed by city and by branch line (plumbing/PVF, HVAC, waterworks, warehouse…

    Arguments

    NameTypeRequired
    statestring
    Two-letter US code.
    Yes
    citystringNo
    typestring
    Substring of the branch line, e.g. "hvac".
    No

    Returns fergusonBranch[]

    interface fergusonBranch {
      state: string;              // "VA"
      city: string;               // "falls church"
      type: string;               // "plumbingpvf" | "hvac" | "waterworks" | "warehouse" | "mechanicalindustrial" | "firefabrication" | …
      branchNumber: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ferguson/findBranches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ferguson.findBranches({ state: "VA" });
  • findProductsFinds Ferguson catalog products (plumbing, HVAC, PVF, waterworks, appliances) whose title contains every word of a keyword query.

    Arguments

    NameTypeRequired
    querystring
    Every word must appear in the title, e.g. "kohler pot filler".
    Yes
    limitnumber
    Default 20, max 100.
    No

    Returns fergusonProduct[]

    interface fergusonProduct {
      productId: string;          // Ferguson's own id, the <id>.html in the url
      title: string;              // url slug as words: product title + manufacturer part number
      url: string;
      lastModified: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/ferguson/findProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ferguson.findProducts({ query: "pot filler", limit: 3 });

Use it from code