mcp-canadiantire

A Model Context Protocol server for Canadian Tire (canadiantire.ca). It exposes the store's catalogue — product search, product detail, store-level stock and a store finder — to MCP clients such as Claude and Cursor.

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

Tools

ct_search

ct_product

ct_store_availability

Default store: product/availability tools default to store 676 (Edmonton Windermere, AB). Set CT_DEFAULT_STORE, or pass storeId / postalCode, to use your local store. Use ct_stores with a postal code to find the right store id.

ct_stores

The store API geosorts by coordinates only (no postal-code search), so a postal code is first geocoded via api.zippopotam.us (free, no key). distanceKm is returned by Canadian Tire.

How it talks to Canadian Tire

canadiantire.ca/api/* is gated by an Azure API Management subscription key — the ocp-apim-subscription-key header. With that key, requests succeed over a plain Node fetch: no cookies, no Akamai _abck, and no TLS (JA3) fingerprinting to work around (unlike some other retailers). So this server talks to the API directly with fetch — no curl subprocess required.

The key is a public client key embedded in the site's JavaScript. If Canadian Tire rotates it (calls start returning 401), set a new one via the CT_SUBSCRIPTION_KEY env var — re-scrape it from the ocp-apim-subscription-key request header of any search XHR on canadiantire.ca.

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": {
    "canadiantire": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_canadiantire/dist/index.js"],
      "env": {
        "CT_DEFAULT_STORE": "676",
        "CT_SUBSCRIPTION_KEY": "<only if the bundled key stops working>"
      }
    }
  }
}

Both env vars are optional:

• CT_DEFAULT_STORE — default store id for the product/availability tools (defaults to

676, Edmonton Windermere, AB).

• CT_SUBSCRIPTION_KEY — overrides the bundled Azure APIM subscription key. See below.

About the subscription key

Every canadiantire.ca/api/* request needs an ocp-apim-subscription-key header. This is a public client key embedded in the site's own JavaScript — not a personal secret — and this server ships with a working value baked in, so it works out of the box with no setup.

If Canadian Tire rotates the key (requests suddenly start returning HTTP 401), grab a fresh one and pass it via CT_SUBSCRIPTION_KEY:

1. Open <https://www.canadiantire.ca> and run any search.
2. In the browser dev tools Network tab, find a request to /api/v1/search/v2/search.
3. Copy the value of its ocp-apim-subscription-key request header.
4. Set it as CT_SUBSCRIPTION_KEY (env var or the client config env block above).

Project layout

src/
  index.ts    MCP server + tool registration (stdio)
  ct.ts       fetch transport for canadiantire.ca (APIM key + headers)
  search.ts   ct_search implementation + response mapping
  product.ts  ct_product + ct_store_availability (productFamily + PriceAvailability APIs)
  stores.ts   ct_stores (store finder + postal-code geocode → nearest)

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.