Connect your assistant to Canadian grocery comparisons.

{
  "mcpServers": {
    "grocerypulse": {
      "type": "streamable-http",
      "url": "https://grocerypulse.ca/api/shopper/mcp"
    }
  }
}

These are documented connection routes. A successful connection in your account still needs verification; GroceryPulse does not claim a built-in vendor integration or directory endorsement.

The shopping-list tool displays a broader dated view and may include older prices or chains whose store location is uncertain. The API applies the stricter checks below.

1. Check the catalogue

   Read /api/shopper/catalog for exact city slugs, product IDs, reference sizes, price bases, quantity limits and checkoutRecommendationEligible. Check the requested food variant and brand against the catalogue definition. Ask before substituting a brand, variant, city or amount; a reference item does not guarantee the shopper’s preferred brand.

2. Request that list

   Send between 1 and 50 distinct item IDs with quantities. Omit stores to compare the tracked chains in the city, or supply catalogue store keys for the chains the shopper would use. A requested chain must also be tracked in that city.

   Whole-package quantities run from 1 to 20. For products sold by weight, quantities are 0.25–10 kg in 0.25 kg steps. The catalogue identifies the basis for each item.

3. Follow the recommendation status

   Name a lowest chain only when recommendation.status is lowest. Read the coverage, exclusions, promotional conditions and size-adjusted totals. An incomplete total cannot support a cheapest-store claim.

4. Give the shopper the evidence

   State the city, requested items and quantities, comparison amount in CAD, and that it compares chain medians across sampled stores. Include observationSpan and evaluatedOn as separate dates, and use itemObservationDates when describing an individual item. Link to comparisonUrl and the returned sourceUrls. Keep the relevant caveats in the answer.

GET https://grocerypulse.ca/api/shopper/compare?city=ottawa&items=1,3

{
  "city": "ottawa",
  "items": [
    { "id": 1, "qty": 1 },
    { "id": 3, "qty": 1 }
  ]
}

Unsupported cities, unknown items, duplicate entries and invalid quantities are rejected explicitly. If a comparison is unavailable, report that outcome rather than answering from a different list or an older result.

lowestOne clear lowest chain

At least two eligible chains price every requested item, and one has a clear lead. Use the returned storeKeys, totals and dates; keep the comparison scope in the answer.

too_close_to_callToo close to choose on price

The lead is within 50 cents or 1% of the lower total. Show the closeStoreKeys and let the shopper consider convenience and travel costs.

insufficient_coverageThe whole list cannot be ranked

There are fewer than two complete eligible chains, or requested items lack eligible prices. Explain the missing items and exclusions. Ask before changing the list.

size_basis_disagreesPackage sizes change the answer

Package-price and reference-size totals favour different chains. Explain that difference and check the quantities the shopper actually needs before choosing.

• Vancouver BC
• Calgary AB
• Edmonton AB
• Saskatoon SK
• Winnipeg MB
• Toronto ON
• Ottawa ON
• Montreal QC
• Quebec City QC
• Moncton NB
• Halifax NS
• Charlottetown PE
• St. John's NL