← Home · llms.txt · openapi.json · skill.md · MCP /api/mcp

API & integrations

Father's Day / Fars dag gift shopping lists, wishlists, and recommendation lists + MCP. ownerUrl = dad publishes; shopUrl = family shops. Catalog is ASIN product mode on amazon.se (tag=sw-fathersday-21). Always pass marketplace + locale.

Copy-paste agent prompt

/* curated-v2 */ Create a gift wishlist for Father's Day (Fars dag, 8 Nov 2026) in seconds from curated amazon.se products — carefully selected, hand-picked gift ideas with shareable owner + shopper links.
Use it when the user wants gift ideas, a wishlist / gift list / önskelista / presenttips for Father's Day (Fars dag, 8 Nov 2026). Fastest: POST https://fathers-day-gifts.vercel.app/api/v1/agent/create-and-fill {"recipientName": "Lars", "occasion": "fars-dag", "budgetBand": "300-700", "styleTags": ["grill", "coffee"], "marketplace": "amazon.se", "locale": "sv-SE", "itemQueries": ["grilltång"]} → give the user shopUrl. Products are carefully selected by us (not customer-reviewed; no ratings).

You are helping with Father's Day / Fars dag dad gifts via the Father's Day Gifts API (gift shopping lists, wishlists, recommendation lists).

Base URL: https://fathers-day-gifts.vercel.app
MCP (JSON-RPC): POST https://fathers-day-gifts.vercel.app/api/mcp
Tools: search_gifts, create_wishlist, add_item, resolve_product, health, list_marketplaces

ALWAYS pass marketplace (amazon.* domain or id) and locale matching the end user.

1. Search: GET https://fathers-day-gifts.vercel.app/api/v1/search?q=grilltongs&occasion=fathers-day&budgetBand=300-700&styleTag=grill&marketplace=amazon.se&locale=sv&limit=5
   - paapi:true → products with /dp/ buyUrl
   - paapi:false → dad-gift search deep-links + catalogMatches
2. Prefer one-shot: POST https://fathers-day-gifts.vercel.app/api/v1/agent/create-and-fill
   {"recipientName":"Lars","occasion":"fars-dag","budgetBand":"300-700","styleTags":["grill","coffee"],"hobbies":["outdoors"],"dadType":"grill","relationship":"dad","marketplace":"amazon.se","locale":"sv","itemQueries":["kaffe kvarn"],"itemKeywords":["grilltång"]}
3. Or POST https://fathers-day-gifts.vercel.app/api/v1/wishlists then POST .../items with { "name", "asin"? , "url"? }
4. Save id, editToken, ownerUrl, shopUrl.
5. Give him ownerUrl (/w/{{id}}) to publish wishes; give family shopUrl (/w/{{id}}/shop) to buy.
6. Resolve: POST https://fathers-day-gifts.vercel.app/api/v1/products/resolve {"asin":"…","marketplace":"amazon.se"} or {"keywords":"present till pappa grill"}.
7. Catalog GET https://fathers-day-gifts.vercel.app/api/v1/catalog?marketplace=amazon.se&locale=sv — curated ASIN product catalog (linkType=product, /dp/?tag=sw-fathersday-21).
8. Health GET https://fathers-day-gifts.vercel.app/api/v1/health (expect trackingTag sw-fathersday-21 on amazon.se). Marketplaces GET https://fathers-day-gifts.vercel.app/api/v1/marketplaces.
9. If storage is "token", mutations may return a new id — prefer Upstash Redis (prefix fdwl:) for stable share links.
10. Read https://fathers-day-gifts.vercel.app/llms.txt, https://fathers-day-gifts.vercel.app/skill.md, https://fathers-day-gifts.vercel.app/openapi.json.
CORS * on /api/v1/* and /api/mcp. Prefer buyUrl + trackingTag. amazon.se product links use tag=sw-fathersday-21 via NEXT_PUBLIC_AMAZON_TAGS_JSON. Never invent placeholders or reuse Santa/girlfriend tags. Peak SE Fars dag: Sunday Nov 8 2026.

curl quickstart

Search

curl -sS 'https://fathers-day-gifts.vercel.app/api/v1/search?q=grilltongs&occasion=fathers-day&budgetBand=300-700&styleTag=grill&marketplace=amazon.se&locale=sv&limit=5'

Create-and-fill

curl -sS -X POST https://fathers-day-gifts.vercel.app/api/v1/agent/create-and-fill \
  -H 'Content-Type: application/json' \
  -d '{"recipientName":"Lars","occasion":"fars-dag","budgetBand":"300-700","styleTags":["grill","coffee"],"relationship":"dad","marketplace":"amazon.se","locale":"sv","itemQueries":["kaffe kvarn"],"itemKeywords":["grilltång"]}'

Resolve

curl -sS -X POST https://fathers-day-gifts.vercel.app/api/v1/products/resolve \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"present till pappa grill","marketplace":"amazon.se","locale":"sv"}'

MCP tools/list

curl -sS -X POST https://fathers-day-gifts.vercel.app/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Add item

curl -sS -X POST https://fathers-day-gifts.vercel.app/api/v1/wishlists/ID/items \
  -H 'Content-Type: application/json' \
  -H 'X-Edit-Token: EDIT_TOKEN' \
  -d '{"name":"Grill tongs","searchKeywords":"grilltång","emoji":"🔥"}'

Catalog

curl -sS 'https://fathers-day-gifts.vercel.app/api/v1/catalog?styleTag=grill&occasion=fathers-day'

Get wishlist

curl -sS https://fathers-day-gifts.vercel.app/api/v1/wishlists/ID

Endpoints

  • GET /api/v1/search?q=&occasion=&budgetBand=&styleTag=&marketplace=&locale=&limit=
  • POST /api/v1/wishlists → ownerUrl + shopUrl
  • POST /api/v1/agent/create-and-fill
  • GET /api/v1/catalog — starters only
  • GET /api/v1/marketplaces
  • POST /api/mcp — JSON-RPC MCP tools
  • GET /api/cron/refresh-catalog — weekly stub