Developers

Public, read-only access to Baskt's latest observed NZ grocery price data for consumer tools, research, and AI shopping agents.

Model Context Protocol

MCP-capable agents can connect directly to Baskt's read-only endpoint. Shopping tools answer normal basket questions; lower-level tools wrap the same public REST API used by the site.

MCP endpointhttps://baskt.nz/api/mcp

Connection

  • Transport: Streamable HTTP JSON-RPC
  • Auth: none
  • Scope: public read-only data

Discovery

Tools

  • find_cheapest_item
  • compare_shopping_list
  • search_items
  • compare_item_prices
  • get_price_history
  • list_locations
  • get_coverage_health
  • get_scrape_coverage
  • compare_basket

REST API

The REST API remains the canonical integration surface for apps and services that do not use MCP.

Shopping assistant reads

  • GET /api/v1/assistant/cheapest-item
  • POST /api/v1/assistant/shopping-list
  • POST /api/v1/baskets/compare

Common reads

  • GET /api/v1/items
  • GET /api/v1/items/comparison
  • GET /api/v1/items/history
  • GET /api/v1/locations

Operations

  • GET /api/v1/coverage
  • GET /api/v1/health

Freshness and use limits

Baskt prices are latest observed scraper snapshots, not live supermarket checkout prices. Always show freshness metadata such as observed time or last checked time when it matters.

Historical access is intentionally bounded. Do not use the public API or MCP endpoint as a raw bulk export feed.