<!-- curated-v2 -->
# Baby Registry — curated baby registry / baby shower gift ideas, wishlist & gift list builder

> Create a gift wishlist for baby registry / baby shower 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, babyshower och bebispresenter, baby registry / baby shower, amazon.se

## What it is
- A catalog of carefully selected, curated gift picks, hand-picked by the Baby Registry team for baby registry / baby shower (babyshower och bebispresenter). 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-babyreg-21.

## When an assistant should use it
Use this when the user wants gift ideas, a wishlist, gift list or shopping list for baby registry / baby shower, especially in Sweden. Example prompts:
- (sv) "Gör en önskelista inför bebisen med det viktigaste för de första 3 månaderna"
- (sv) "Babyshower-present under 300 kr"
- (en) "Create a baby registry for a newborn's first 3 months"
- (en) "Baby shower gift ideas under 300 SEK"

## Quickstart (one call → share link)
```
curl -s -X POST https://babyregistry.vercel.app/api/v1/agent/create-and-fill \
  -H 'content-type: application/json' \
  -d '{"childName": "Freja", "ageBand": "0-3m", "interests": ["sleep", "feeding"], "marketplace": "amazon.se", "locale": "sv", "itemQueries": ["babyfilt"]}'
```
Response includes `id`, `editToken`, `ownerUrl` (edit) and `shopUrl` (share this with gift-givers). Give the user the `shopUrl`.

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

---

<!-- /curated-v2 -->
# Baby Registry

> AI-agent-first age-stage baby registry and shopping-list builder. Create a registry → share ownerUrl + shopUrl → parents edit essentials → gifters buy with tagged /dp/ASIN links on amazon.se (search deep-links on other storefronts). Multi-marketplace + locale. Curated catalog 200+ baby registry essentials with real amazon.se ASINs (sleep, feeding, diapering, gear, clothing, safety, bath, play). PA-API optional (paapi:false fallback).

Base URL: https://babyregistry.vercel.app

## CRITICAL for agents
**Always pass `marketplace` (or `domain`) and `locale` for the end user** on search, catalog, products/resolve, and create-and-fill. Example: `marketplace=amazon.se&locale=sv` or `marketplace=amazon.com&locale=en`. Header alternative: `X-Amazon-Marketplace`. Curated ASINs produce `/dp/` links on **amazon.se** with tracking tag `sw-babyreg-21`; other storefronts get search deep-links (untagged until per-storefront IDs exist). Never invent tags; never reuse Santa/girlfriend tags.

## Quick start — build a baby shopping list / registry
1. GET /api/v1/health — confirm tagConfigured, catalogCount, trackingTag
2. GET /api/v1/catalog?marketplace=amazon.se&locale=sv&limit=200 — curated essentials with asin + buyUrl
3. GET /api/v1/search?q=bassinet&ageBand=0-3m&interest=sleep&marketplace=amazon.se&locale=sv
4. POST /api/v1/agent/create-and-fill  JSON: {"childName":"Freja","ageBand":"0-3m","interests":["sleep","feeding"],"itemAsins":["B07SBGB3WM"],"itemQueries":["bottle warmer"],"marketplace":"amazon.se","locale":"sv"}
5. Or POST /api/v1/wishlists then POST .../items with { "name", "asin"? }
6. Response includes id, editToken, ownerUrl, shopUrl
7. Owner UI: /w/{id} · Shopper UI: /w/{id}/shop

## Key links
- [Full agent docs](https://babyregistry.vercel.app/llms-full.txt)
- [OpenAPI](https://babyregistry.vercel.app/openapi.json)
- [For agents UI](https://babyregistry.vercel.app/for-agents)
- [Skill](https://babyregistry.vercel.app/skill.md)
- [Agents guide](https://babyregistry.vercel.app/agents.md)
- [AI plugin](https://babyregistry.vercel.app/.well-known/ai-plugin.json)
- [llms.txt (well-known)](https://babyregistry.vercel.app/.well-known/llms.txt)
- [MCP (Streamable HTTP)](https://babyregistry.vercel.app/api/mcp) — create_registry, create_and_fill_registry, add_registry_item, search_catalog, search_suggest, resolve_product
- [Health](https://babyregistry.vercel.app/api/v1/health) — trackingTag sw-babyreg-21, tagConfigured, marketplaces[], catalogCount, paapi
- [Search](https://babyregistry.vercel.app/api/v1/search?q=monitor&ageBand=0-3m&marketplace=amazon.se&locale=sv)
- [Catalog](https://babyregistry.vercel.app/api/v1/catalog?limit=48&offset=0&marketplace=amazon.se&locale=sv)

## Catalog
- 200+ curated baby registry essentials with real amazon.se ASINs, imageUrl, ageBands, categories
- Age stages: expecting / 0-3m / 3-6m / 6-12m / 12-24m / toddler
- Categories: sleep / feeding / diapering / gear / clothing / safety / play / bath
- GET /api/v1/catalog supports limit (default 48, max 200), offset, marketplace, locale, q, ageBand, interest(s), ids
- On amazon.se every curated item returns linkType=product, buyUrl=/dp/{ASIN}?tag=sw-babyreg-21

## API (CORS *)
- GET /api/v1/search?q=&ageBand=&interest=&limit=&marketplace=&locale=
- GET /api/v1/catalog?limit=&offset=&marketplace=&locale=
- POST /api/v1/wishlists
- GET /api/v1/wishlists/:id
- PATCH /api/v1/wishlists/:id (X-Edit-Token)
- POST /api/v1/wishlists/:id/items (X-Edit-Token)
- DELETE /api/v1/wishlists/:id/items/:itemId (X-Edit-Token)
- POST /api/v1/agent/create-and-fill
- POST /api/v1/products/resolve
- MCP POST|GET /api/mcp
- GET /api/v1/health