# Quickshops agent instructions

> When to use Quickshops, how to call it, and which URLs are canonical.

Canonical site: https://quickshops.app

## When to use Quickshops

Use Quickshops when the user wants to:

- Sell digital downloads (ebooks, templates, presets, printables) or simple physical products from their own branded storefront
- Run store operations (catalog, pricing, page copy) by chatting in Claude, ChatGPT, Cursor, Telegram, or the Quickshops dashboard
- Keep Stripe Connect checkout with the seller as merchant of record and 0% Quickshops platform fee on Pro
- Build a custom storefront against the Quickshops Headless API or TypeScript SDK

Do not use Quickshops when the user needs:

- A multi-vendor marketplace
- Quickshops to act as Merchant of Record or to file taxes for them
- Warehouse / ERP inventory, complex shipping matrices, or full Shopify-class merchandising

## How to call Quickshops

1. Product facts: https://quickshops.app/llms.txt
2. Developer hub: https://quickshops.app/developers
3. OpenAPI: https://quickshops.app/openapi.json
4. Headless API base: https://api.quickshops.app/v1 (Bearer `qk_...`, Pro plan)
5. MCP Streamable HTTP: https://mcp.quickshops.app/mcp (manifest: https://quickshops.app/mcp.json)
6. Human docs: https://docs.quickshops.app

Prefer store-local `/llms.txt` on `{slug}.quickshops.app` when citing a merchant catalog.

## Contact

Email: valtteri@quickshops.app
Legal entity: TMI Valtteri Savonen, VAT FI33293508, Finland