The Builders Supply catalog

Read-only catalog of The Builders Supply: door and builders hardware, prices and availability.

Should I use this

Quality & Safety

A
Description quality
90%
Schema completeness
90%
Naming quality
90%
Poisoning risk
100%
Permission match
90%
Protocol compliance
100%

Findings (3)

  • LOWTool 'compare_products' description lacks action verbin compare_products
  • LOWTool 'store_policies' description lacks action verbin store_policies
  • LOWTool 'browse_category' suggests web access but openWorldHint=falsein browse_category

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,503Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (1.17% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "catalog": {
      "url": "https://mcp.thebuilderssupply.com/mcp"
    }
  }
}

Remote endpoints

https://mcp.thebuilderssupply.com/mcpstreamable-http

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢browse_category(categoryId, orderableOnly, limit, offset)

Products of a category and of all its subcategories, alphabetically, up to 20 per page.

Input Schema

{
  "type": "object",
  "properties": {
    "categoryId": {
      "type": "integer",
      "format": "int64",
      "description": "category id from list_categories"
    },
    "orderableOnly": {
      "type": "boolean",
      "description": "true = only items that can be ordered now"
    },
    "limit": {
      "type": "integer",
      "format": "int32",
      "description": "max results, 1-20, default 10"
    },
    "offset": {
      "type": "integer",
      "format": "int32",
      "description": "offset for the next page, default 0"
    }
  },
  "required": [
    "categoryId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cart_link(items)

Prepares ordering for chosen items: one product page link per item, the quantity rules and whether the published count covers the quantity. It does NOT fill a cart (prefilled_cart is always false): the customer opens the link, enters the quantity and checks out on the store site. This server takes no orders and no payment data.

Input Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "quantity": {
            "type": "integer",
            "format": "int32"
          },
          "sku": {
            "type": "string"
          }
        },
        "required": [
          "quantity",
          "sku"
        ]
      },
      "description": "items as SKU and quantity"
    }
  },
  "required": [
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢check_availability(skus, quantity)

Availability of one or more SKUs with the meaning of each state: in stock with a real count, available with unknown quantity, ordered from the supplier with a lead time, made to order, assembled to order, out of stock, not for sale.

Input Schema

{
  "type": "object",
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "one to 10 store SKUs"
    },
    "quantity": {
      "type": "integer",
      "format": "int32",
      "description": "quantity wanted, checked against order multiples and the published count"
    }
  },
  "required": [
    "skus"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢compare_products(skus)

Side-by-side attributes, price, availability, dimensions and weight of 2 to 10 SKUs.

Input Schema

{
  "type": "object",
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2 to 10 store SKUs"
    }
  },
  "required": [
    "skus"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_product(sku)

Everything the store publishes about one product by SKU: description, attributes, finish and grade, dimensions and weight with units, order multiples, availability state with its meaning, lead time, images, documents, categories and the product page link.

Input Schema

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "store SKU, e.g. SCH_02007"
    }
  },
  "required": [
    "sku"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_categories(parentId)

The category tree of the store: top level without parent_id, children with parent_id. Use the id in search_products or browse_category.

Input Schema

{
  "type": "object",
  "properties": {
    "parentId": {
      "type": "integer",
      "format": "int64",
      "description": "parent category id; omit for the top level"
    }
  },
  "required": [],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢search_products(query, brand, categoryId, orderableOnly, limit, ...)

Full-text search of the store catalog by words, SKU, brand or part number. Returns up to 20 matches with price, availability state and the product page link. For one person's question, not for copying the catalog. Use orderable_only=true to skip items that cannot be bought now.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "words, SKU or manufacturer part number"
    },
    "brand": {
      "type": "string",
      "description": "brand name to restrict to, e.g. Schlage"
    },
    "categoryId": {
      "type": "integer",
      "format": "int64",
      "description": "category id from list_categories to restrict to"
    },
    "orderableOnly": {
      "type": "boolean",
      "description": "true = only items that can be ordered now"
    },
    "limit": {
      "type": "integer",
      "format": "int32",
      "description": "max results, 1-20, default 10"
    },
    "offset": {
      "type": "integer",
      "format": "int32",
      "description": "offset for the next page, default 0"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢store_policies

Shipping, free shipping, freight, returns, refunds, warranty, payment and contact rules of the store in plain text, with links to the full pages.

Input Schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Output Schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools