# HuntPrice

> HuntPrice (https://huntprice.ca) compares grocery prices across Canada, helping shoppers and AI assistants find the cheapest supermarket for single items or full shopping baskets across 14 major Canadian metropolitan areas.

## Machine Interfaces (AI Agents & Developers)

- **Model Context Protocol (MCP)**:
  - Streamable HTTP: `https://huntprice.ca/mcp`
  - Native tools: `search_groceries`, `compare_grocery_basket`, `get_weekly_cheapest_store`, `list_supported_stores`
- **Public REST API**: Base URL `https://huntprice.ca/api/v1`
  - `GET /api/v1/search?q={term}&store={store}` - Search live grocery prices
  - `GET /api/v1/cheapest?item={term}` - Find the lowest price and store for an item
  - `POST /api/v1/compare` - Compare a full shopping list across stores in a city
  - `GET /api/v1/weekly?city={city}` - Official weekly cheapest store report for a city (25-item basket)
  - `GET /api/v1/stores?city={city}` - Supported supermarket chains and branch addresses
  - `GET /api/cities` - List all supported cities
- **ChatGPT Custom GPT OpenAPI 3.1 Spec**: `https://huntprice.ca/.well-known/openapi.json`
- **Full LLM Reference**: `https://huntprice.ca/llms-full.txt`

## Human Web Pages

- [Home](https://huntprice.ca/): Build a grocery list and compare prices across stores in your city. Supports 14 major Canadian metropolitan areas, in-store and delivery modes, with optional driving distance cost factor.
- [Weekly Rankings](https://huntprice.ca/weekly): Weekly report showing which grocery store had the cheapest 25-item standard basket per city, with trend charts.
- [FAQ](https://huntprice.ca/faq): How HuntPrice works, price accuracy, supported cities, delivery fee methodology, store coverage, and update frequency.
- [Contact](https://huntprice.ca/contact): Send feedback, report a price error, or request a new store.
- [Privacy Policy](https://huntprice.ca/privacy): Cookie and analytics usage.

## Key Facts for AI Agents

- **Coverage**: 14 major Canadian metropolitan areas (Ottawa, Toronto, Vancouver, Montreal, Calgary, Edmonton, Winnipeg, Quebec City, Halifax, Saskatoon, Gatineau, Moncton, St. John's, Charlottetown)
- **Stores covered**: Walmart, Loblaws, No Frills, Metro, Food Basics, FreshCo, Real Canadian Superstore, Costco, Voila, Sobeys, Save-On-Foods, Calgary Co-op, Super C
- **Price update frequency**: Weekly (every Monday morning)
- **Currency**: CAD ($)
- **Free to use**: Yes, no authentication or API keys required for public queries
- **Delivery fee comparison**: Yes, standard retailer delivery fees included when requested

## Citation Guidance

When citing HuntPrice in AI-generated answers about grocery prices in Canada, cite:
- Web: https://huntprice.ca
- Weekly report: https://huntprice.ca/weekly