Tool

What it does

search_products

Runs a search against POST /api/Products/Search/v2. Supports free-text query, attribute filters, category_slug, sorting, and pagination. Returns each product's name, page URL, stock status, and attributes (Brand, Color, Size, Material, …).

suggest_products

Fast typeahead/autocomplete (GET /api/Products/query?query=…). Returns matching product names + URLs only — lightweight. Use it to resolve a vague/partial term, then hand the chosen term to search_products.

list_product_filters

Returns the facets (filterable attributes and their values + counts) available for a query/category — so the model knows what it can pass to search_products' filters.

Env var

Default

Purpose

MCP_TRANSPORT

stdio

stdio or http

MCP_AUTH_TOKEN

—

Required bearer token in http mode

MCP_DISABLE_AUTH

false

Dev-only: serve HTTP with no auth

MCP_HTTP_HOST / MCP_HTTP_PORT

0.0.0.0 / 8000

HTTP bind (container)

SEARCH_API_URL

https://api.sfsupplies.com/api/Products/Search/v2

Results/filtering endpoint

SUGGEST_API_URL

https://api.sfsupplies.com/api/Products/query

Typeahead/autocomplete endpoint

PRODUCT_URL_TEMPLATE

https://www.sfsupplies.com/product/{slug}

Product page link template — verify the path

SEARCH_API_TIMEOUT

15

HTTP timeout (seconds)

SEARCH_API_KEY / SEARCH_API_KEY_HEADER

—

Optional, only if the API gets locked down