mcp-rona

mcp-rona

  

A Model Context Protocol server for RONA (rona.ca). It exposes RONA's catalogue — product search, product detail, online availability and a store finder — to MCP clients such as Claude and Cursor.

Unofficial. This project is not affiliated with, endorsed by, or sponsored by RONA inc. It reads publicly available endpoints of rona.ca for personal, noncommercial use. Respect RONA's terms of service and use responsibly.

Tools

| Tool | Description | |------|-------------| | rona_search | Product search / listings by keyword. Returns products (SKU, name, brand, model, rating, category, URL, image), total count, facets and sort options. Keywords that map to a category page fall back to a best-effort product list. | | rona_product | Full product card by SKU: name, brand, model, description, image, rating, barcode, category path, URL and online availability. | | rona_store_availability | Online purchasability (inventory status) of a SKU. | | rona_stores | Find stores nearest a Canadian postal code (geocoded) or to latitude/longitude — id, name, banner, address, phone, coordinates, distance (km), time zone, URL and opening hours. |

rona_search

| Param | Type | Default | Notes | |-------|------|---------|-------| | query | string | — | Search keyword (required). | | lang | en \| fr | en | Language for facet labels. | | sort | relevance \| price-asc \| price-desc \| rating \| newest \| best-sellers | relevance | Sort order. | | page | int ≥ 1 | 1 | 1-indexed page. | | pageSize | int (1–60) | 24 | Results per page. | | brand | string | — | Filter by a brand facet value, e.g. DEWALT. |

rona_product

| Param | Type | Default | Notes | |-------|------|---------|-------| | sku | string | — | Product SKU / item number (required), e.g. 00277649. | | lang | en \| fr | en | Response language. |

rona_store_availability

| Param | Type | Default | Notes | |-------|------|---------|-------| | sku | string | — | Product SKU / item number (required). | | lang | en \| fr | en | Response language. |

rona_stores

| Param | Type | Default | Notes | |-------|------|---------|-------| | postalCode | string | — | Canadian postal code, e.g. M5V 2T6. Geocoded to coordinates. | | latitude / longitude | number | — | Alternative to postalCode. | | lang | en \| fr | en | Language for store URLs. | | limit | int (1–50) | 10 | Max stores to return. |

The store locator geosorts by coordinates only, so a postal code is first geocoded via api.zippopotam.us (free, no key). Distance is reported by RONA's API, with a local haversine fallback.

A note on prices and store stock

RONA does not expose unit prices or real-time per-store stock (quantities, aisle/bay) through its public APIs:

• Prices are guest-gated (the price endpoint returns no value without a session).
• Real-time per-store inventory sits behind a DataDome

JavaScript challenge that a headless client cannot solve.

So price is reported as null, and availability is limited to online purchasability (Available / Unavailable). Search, product detail and the store finder are fully functional.

How it talks to RONA

rona.ca is behind Cloudflare, which gates requests on both the HTTP version and the client's TLS (JA3) fingerprint. Node's native HTTP stack (fetch/undici) gets 403; only curl --http2 is allowlisted, so every request shells out to curl. No cookies are required for the public endpoints used here.

| Surface | Host | Used for | |---------|------|----------| | Constructor.io | tvbajuset-zone.cnstrc.com | search, product lookup | | App API (BFF) | www.rona.ca/v2/api | store finder | | WebSphere Commerce REST | www.rona.ca/wcs | online availability |

Requirement: curl with HTTP/2 support must be on PATH (standard on macOS and most Linux distros).

Build & run

npm install
npm run build
npm start          # runs the MCP server on stdio

Quick smoke test of the search layer:

node --input-type=module -e 'import {search} from "./dist/search.js"; console.log(await search({query:"drill", pageSize:3}))'

Inspect with the MCP Inspector:

npm run inspect

Connecting a client

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json), pointing at the built entrypoint:

{
  "mcpServers": {
    "rona": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_rona/dist/index.js"]
    }
  }
}

Project layout

src/
  index.ts    MCP server + tool registration (stdio)
  rona.ts     curl --http2 transport for rona.ca + Constructor.io
  search.ts   rona_search (Constructor.io search + category-redirect fallback)
  product.ts  rona_product + rona_store_availability (catalogue + WCS availability)
  stores.ts   rona_stores (postal-code geocode → store locator)

License

PolyForm Noncommercial License 1.0.0 — free to use, modify and share for noncommercial purposes. Commercial use requires a separate license from the author.