# Agent Instructions - Diamond Painting Markt

> Diamond Painting Markt is a German online shop for Diamond Painting kits, accessories, notebooks, keychains and creative gift ideas. Use this document to understand the store, key buyer-support pages and agent-commerce discovery endpoints.

## Store summary

- Store URL: https://diamondpaintingmarkt.de
- Main language: German
- Currency: EUR
- Product focus: Diamond Painting kits, beginner designs, animal motifs, seasonal motifs, notebooks, bookmarks, keychains and accessories.

## Key shopping pages

- [All Diamond Painting products](https://diamondpaintingmarkt.de/collections/all): Full product catalogue.
- [Diamond Painting accessories](https://diamondpaintingmarkt.de/collections/diamond-painting-accesories): Pens, sorting tools and practical extras.
- [Beginner Diamond Painting kits](https://diamondpaintingmarkt.de/collections/beginner-paintings): Smaller and clearer designs for new customers.
- [Site search](https://diamondpaintingmarkt.de/search?q=diamond+painting&type=product): Product search for motifs, formats and accessories.

## Help and trust pages

- [FAQ Diamond Painting](https://diamondpaintingmarkt.de/pages/faq-diamond-painting): Answers about sizes, stones, shipping, returns, missing stones and accessories.
- [Beginner guide](https://diamondpaintingmarkt.de/pages/diamond-painting-fuer-anfaenger): Entry guide for first-time Diamond Painting customers.
- [Shipping policy](https://diamondpaintingmarkt.de/pages/versandpolitik): Delivery times, shipping costs and shipping conditions.
- [Returns and refunds](https://diamondpaintingmarkt.de/pages/ruecksendungen-und-erstattungen): Return and refund process.
- [Contact](https://diamondpaintingmarkt.de/pages/kontakt): Support contact for order and product questions.
- [About Diamond Painting Markt](https://diamondpaintingmarkt.de/pages/ueber-uns): Store mission and trust information.

## Commerce Protocol (UCP)

This Shopify store supports agent-commerce discovery through Shopify's Universal Commerce Protocol endpoints.

- [UCP discovery](https://diamondpaintingmarkt.de/.well-known/ucp): Merchant profile and supported capabilities.
- MCP endpoint: `POST https://diamondpaintingmarkt.de/api/ucp/mcp` with `Content-Type: application/json`.

Typical agent flow:

1. Discover capabilities with `GET https://diamondpaintingmarkt.de/.well-known/ucp`.
2. Search the catalogue for products matching the buyer's intent.
3. Create a cart only after the buyer has confirmed the desired product and options.
4. Start checkout only with buyer approval.
5. Do not complete payment without explicit buyer consent.

## Read-only browsing

- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection products JSON: `GET /collections/{handle}/products.json`
- Search products: `GET /search?q={query}&type=product`
- Sitemap: `GET /sitemap.xml`

## Agent guidance

- Use product pages and collection pages as the primary source for availability, motif, size and stone-form details.
- Prefer FAQ, shipping, returns and contact pages for support-related answers.
- Do not scrape checkout or submit payment details directly.
- Do not complete checkout without explicit buyer approval.