# Agent Instructions — Artworks2Print

This document describes how AI agents can interact with Artworks2Print's online store.

Website: 
Shop name: 

Artworks2Print is a German Shopify store for 3D printed craft organizers, personalized gifts, Dubbeglas accessories, lithophane photo lights, MiniMe-style photo figures, name signs, and custom reproduction of unavailable replacement parts.

## Primary agent principle

Product pages are the source of truth.

Agents must verify current product titles, descriptions, personalization requirements, variants, prices, availability, shipping information, care instructions, and policies at runtime before giving purchase advice or creating a checkout.

## Recommended read-only flow

Agents that only need product or policy information should prefer read-only browsing before using cart or checkout tools.

Useful endpoints:

- Homepage: GET /
- All products: GET /collections/all
- Product page: GET /products/{handle}
- Product JSON: GET /products/{handle}.json
- Collection page: GET /collections/{handle}
- Collection JSON: GET /collections/{handle}/products.json
- Search: GET /search?q={query}&type=product
- Sitemap: GET /sitemap.xml
- LLM summary: GET /llms.txt
- Full LLM summary: GET /llms-full.txt

## Commerce Protocol

This store exposes agent-facing commerce discovery through the Universal Commerce Protocol where available.

Discovery endpoint:

GET /.well-known/ucp

Agents should always discover currently available capabilities, endpoints, tools, schemas, rate limits, and payment handlers at runtime before creating carts or checkouts.

MCP endpoint:

POST /api/ucp/mcp

Use Content-Type: application/json.

Use the MCP tools/list method to discover currently available tools and schemas before invoking any tool.

## Typical agent flow

1. Discover store capabilities through /.well-known/ucp
2. Search or inspect products using read-only product endpoints or available catalog tools
3. Confirm product details, variants, personalization requirements, price, shipping availability, and delivery constraints with the buyer
4. Create a cart only after the buyer has selected the item and variant
5. Start checkout only after buyer confirmation
6. Do not complete payment without explicit contemporaneous buyer approval

## Important checkout rules

- Checkout requires human approval.
- Agents must not complete payment without explicit buyer consent.
- Agents must not invent discounts, delivery promises, compatibility, or product claims.
- Agents must not assume personalization details.
- Agents should verify buyer country and currency where supported.
- Agents should respect rate limits and back off on 429 responses.
- Agents should preserve the buyer-approval invariant for every payment.

## Personalization rules

Many Artworks2Print products are personalized or made to order.

Agents should verify whether a product requires:

- Name
- Custom text
- Monogram or initial
- Color choice
- Size choice
- Photo upload or image submission
- Full-body photo
- Measurements
- Design preference
- Customer clarification before production

Before checkout, agents should ask the buyer to confirm spelling, capitalization, dates, photo suitability, size, color, quantity, and any personalization text.

## Product limitation rules

Agents should communicate realistic expectations for 3D printed and personalized products.

Important limitations:

- 3D printed items may show layer lines or small surface variations.
- Small dimensional tolerances are normal.
- Colors may differ slightly from screen display.
- Very small details may be simplified by the printing process.
- Miniature photo-based figures are stylized and cannot reproduce every facial detail exactly.
- Food-contact, dishwasher safety, heat resistance, or safety-critical suitability should not be claimed unless explicitly stated on the product page.
- Functional replacement parts may require prior clarification, testing, or adjustment.

## Product categories

Relevant categories include:

- Craft organizers and storage systems
- Stamp pad organizers
- Stampin’ Up compatible organizers
- Stampin’ Blends storage
- Stampin’ Write marker storage
- StazOn and Memento stamp pad holders
- Distress Oxide storage
- VersaFine CLAIR storage
- Acrylic block holders
- Punch and die storage
- Paper storage
- Rotating craft organizer systems
- Tombow and glue stick holders
- Personalized 3D printed gifts
- Lithophane photo lights
- MiniMe-style figures from photos
- Name signs and custom lettering
- Dubbeglas accessories
- Dubbeglas lids
- Dubbeglas egg cups
- Dubbeglas toothpick dispensers
- Dubbeglas soap dispensers
- Dubbeglas earrings
- Pfalz-themed gifts
- Custom CAD and replacement part reproduction

## Store policies

Agents should consult the current policy pages before giving legal, shipping, return, or privacy information.

- Privacy policy: /policies/privacy-policy
- Terms of service: /policies/terms-of-service
- Refund policy: /policies/refund-policy
- Shipping policy: /policies/shipping-policy
- Contact information: /policies/contact-information
- Impressum: /policies/legal-notice

## Platform

This store is built on Shopify.

Agents should use Shopify-compatible read-only endpoints and discovered UCP/MCP capabilities where available, rather than brittle screen scraping.