<!-- curated-v2 -->
# Pet Welcome Box — curated new puppy / kitten gift ideas, wishlist & gift list builder

> Create a gift wishlist for new puppy / kitten in seconds from curated amazon.se products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.

**Keywords:** gift ideas, wishlist, gift list, shopping list, presenttips, önskelista, presentlista, ny valp eller kattunge, new puppy / kitten, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Pet Welcome Box team for new puppy / kitten (ny valp eller kattunge). Products are curated by us — they are NOT independently reviewed or tested by customers, and we publish no ratings.
- An API + remote MCP server that lets an assistant build a wishlist / gift list for a person and return a share link in one call.
- Market: Sweden (amazon.se, SEK, sv-SE). Buy links are amazon.se /dp/ links with tag sw-petbox-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for new puppy / kitten, especially in Sweden. Example prompts:
- (sv) "Vad behöver jag köpa när vi hämtar valpen?"
- (sv) "Present till vän som skaffat kattunge"
- (en) "What do I need for a new puppy?"
- (en) "Gift for a friend who just got a kitten"

## Quickstart (one call → share link)
```
curl -s -X POST https://pet-welcome-box.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"petName": "Luna", "species": "dog", "stage": "puppy", "budgetBand": "500-1500", "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["hundbädd"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

- Remote MCP: https://pet-welcome-box.vercel.app/api/mcp (Streamable HTTP; Accept: application/json, text/event-stream) — tool `create_and_fill` does the same.
- Browse curated picks (Swedish): https://pet-welcome-box.vercel.app/presenttips
- OpenAPI: https://pet-welcome-box.vercel.app/openapi.json · Skill: https://pet-welcome-box.vercel.app/skill.md · Guide: https://pet-welcome-box.vercel.app/for-agents · Full: https://pet-welcome-box.vercel.app/llms-full.txt

---

<!-- /curated-v2 -->
# Pet Welcome Box

> Gift inspiration and pet shopping lists for first-30-days welcome boxes — curated recommendation lists with Amazon buy links. AI-agent-first.

Site: https://pet-welcome-box.vercel.app
MCP: https://pet-welcome-box.vercel.app/api/mcp

## Keywords
pet shopping list · pet welcome box · new puppy checklist · new kitten kit · dog recommendation list · cat recommendation list · gift inspiration

## API
- Health: GET /api/v1/health
- Search: GET /api/v1/search?q=&species=&sizeBand=&stage=&kitCategory=&budgetBand=&marketplace=&locale=&limit=
- Create: POST /api/v1/wishlists  { petName?, species, sizeBand, stage?, budgetBand, kitCategories, marketplace, locale }
- Create+fill: POST /api/v1/agent/create-and-fill
- Catalog: GET /api/v1/catalog?species=&sizeBand=&kitCategory=&marketplace=&locale=
- Resolve: POST /api/v1/products/resolve { asin? , url? , keywords? , species? , sizeBand? , marketplace , locale } → buyUrl
- Marketplaces: GET /api/v1/marketplaces
- OpenAPI: /openapi.json · Skill: /skill.md · Agents: /agents.md · UI docs: /for-agents

Returns ownerUrl (builds kit) and shopUrl (buys). CORS *.
Always pass marketplace + locale. Redis prefix: pwb:.

amazon.se buy links use Associates tag sw-petbox-21 when configured via NEXT_PUBLIC_AMAZON_TAGS_JSON. Never invent placeholder tags or reuse tags from other verticals.