MadMax Trade Supply

Find replacement filters, alarms and parts by OEM part number, size or appliance model.

Hosted MCP Server

npx add-mcp 'https://www.madmaxsupply.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

For AI agents and developers

AI assistants, shopping agents and scripts can search our catalog, check what fits, and hand a shopper a ready-to-pay cart. No key or sign-up is needed. These tools never place an order or charge a card; everything is read-only except submit_feedback, which only sends us a note. The shopper opens the cart link, enters the address and pays on the normal checkout page.

MCP server

Remote MCP server (Streamable HTTP, no auth): https://www.madmaxsupply.com/mcp

Tools: search_parts, get_product, check_fit, create_checkout_link, list_categories, get_store_policies, submit_feedback.

Add it to an MCP client as a remote/custom connector with that URL. Server card: /.well-known/mcp.json.

REST API (OpenAPI 3.1)

Spec: /openapi.json. CORS is open.

  • GET /api/agent/search?q=<keywords, OEM part no. or size>&ship_to_state=MN, for example search WF3CB
  • GET /api/agent/fit?q=20x25x4: what we carry for an OEM part number, filter size or model name
  • GET /api/agent/product/<SKU>: price for the ship-to state, shipping, return window, auto-ship options
  • GET /api/agent/checkout-link?items=SKU:qty[:months],...&ship_to_state=MN (or POST JSON): returns a pre-filled cart_url
  • GET /api/agent/policies and GET /api/agent/categories
  • POST /api/feedback: report a missing part or blocker (see below)

Cart links

https://www.madmaxsupply.com/cart/?add=MM-RF-891B5F:1,MM-AF-7859F0:2:6 opens the cart with those items. The optional third value sets Subscribe & auto-ship (1, 2, 3, 6 or 12 months) on eligible items. We email a notice before any price change on a subscription.

Prices, shipping and tax

Prices are in USD. Prices include any sales tax we're required to collect. No tax is added at checkout. Prices can differ slightly by state, so the API takes ship_to_state. Most items include shipping within the contiguous US. AK, HI, US territories and APO/FPO addresses get a shipping quote and a payment link before any charge. One-time orders are authorized at checkout and charged when the order is confirmed in stock. Returns: see each item's window and our terms.

Feeds and data

Report missing parts or blockers

AI agents: if a shopper needs a part we don't list, a fit is unclear, or checkout is blocked, tell us with the MCP tool submit_feedback or POST /api/feedback (JSON: type = missing_part, fit_question, checkout_blocked, data_issue or other; message; optional part_number, sku, query, agent_name, contact_email). A person reviews every report. Nothing is sent back automatically, and it never places an order.

Good-bot rules

Please keep it under about one request per second, cache what you can (catalog data changes at most a few times a day), and never tell a shopper an order was placed until they have paid at checkout. Fit matches come from product titles, so ask the shopper to confirm against the old part. Questions or a bulk/API need: tamara@madmaxsupply.com.