# iDrinkCoffee.com

> Canada's premier specialty coffee retailer helping you Bring the Cafe Home since 2009.

We are an authorized dealer for top brands including ECM, Profitec, Eureka, Mahlkonig, Bezzera, Quick Mill and more. Our mission is to help coffee enthusiasts Bring the Cafe Home with professional-grade espresso machines, precision grinders, brewing equipment, and curated coffee subscriptions.

## Main Pages

- [Homepage](https://idrinkcoffee.com): Browse our latest products and featured collections
- [About Us](https://idrinkcoffee.com/pages/about-us): Learn about our story and mission
- [All Products](https://idrinkcoffee.com/collections/all): Browse our complete catalog
- [Coffee Subscriptions](https://idrinkcoffee.com/coffee-subscription): Weekly/Monthly coffee delivery service
- [Tea Subscriptions](https://idrinkcoffee.com/tea-subscription): Weekly/Monthly tea delivery service
- [Account](https://idrinkcoffee.com/account): Manage your account, orders, and subscriptions


## Universal Commerce Protocol (UCP)

iDrinkCoffee supports the Universal Commerce Protocol, enabling AI agents to discover our products and complete purchases directly.

### UCP Discovery
- [UCP Manifest](https://idrinkcoffee.com/.well-known/ucp): Discover capabilities, payment handlers, and API endpoints

### UCP Checkout API
- `POST /api/ucp/checkout-sessions`: Create a new checkout session
- `GET /api/ucp/checkout-sessions/{id}`: Get session details
- `PATCH /api/ucp/checkout-sessions/{id}`: Update session (add items, buyer info, discounts)
- `POST /api/ucp/checkout-sessions/{id}/complete`: Get Shopify checkout URL

For full UCP integration details, see the discovery manifest.

## API Endpoints for LLM Access

### Search APIs
- [Search JSON Format](https://idrinkcoffee.com/search/{query}.json): Search results with product matches
- [Search Markdown Format](https://idrinkcoffee.com/search/{query}.md): Human-readable search results

Example:
- JSON: https://idrinkcoffee.com/search/espresso-machine.json
- Markdown: https://idrinkcoffee.com/search/espresso-machine.md

Note: Search queries should be "handelized" (lowercase, hyphens for spaces).

### Product APIs
- [Product JSON Format](https://idrinkcoffee.com/products/{handle}.json): Structured product data with variants, pricing, and metadata
- [Product Markdown Format](https://idrinkcoffee.com/products/{handle}.md): Human-readable product information

Example:
- JSON: https://idrinkcoffee.com/products/profitec-move-espresso-machine.json
- Markdown: https://idrinkcoffee.com/products/profitec-move-espresso-machine.md

### Collection APIs
- [Collection JSON Format](https://idrinkcoffee.com/collections/{handle}.json): Structured collection data with product listings
- [Collection Markdown Format](https://idrinkcoffee.com/collections/{handle}.md): Human-readable collection information

Example:
- JSON: https://idrinkcoffee.com/collections/espresso-machines.json
- Markdown: https://idrinkcoffee.com/collections/espresso-machines.md

Parameters supported:
- `page`: Page number for pagination (default: 1)
- `limit`: Items per page (default: 50)
- `sortKey`: Sort products by (COLLECTION_DEFAULT, PRICE, CREATED)
- `reverse`: Reverse sort order (true/false)

## MCP Server
- [MCP Server](https://idrinkcoffee.com/api/mcp-enhanced): Enhanced product search API (JSON-RPC protocol)
- [Shopify Storefront API powered MCP Server](https://idrinkcoffee.com/api/mcp): Shopify Storefront API powered MCP Server

## Technical Information

- **Platform**: Shopify Hydrogen (React-based)
- **Primary Language**: English (en-CA)
- **Currency**: CAD (also supports USD)
- **Structured Data**: Product, Organization, Store, WebSite, FAQ, Review, BreadcrumbList schemas
- **Sitemap**: [XML Sitemap](https://idrinkcoffee.com/sitemap.xml)

## Contact

- **General Inquiries**: sales@idrinkcoffee.com
- **Phone**: 1-800-425-5405

## Optional

- [Shipping & Returns Policy](https://idrinkcoffee.com/pages/shipping-and-returns)
- [Privacy Policy](https://idrinkcoffee.com/pages/privacy-policy)