# Blssit

> Fast Scandinavian wishlist web app — save wishes from any online store, share wishlists safely with friends and family, and avoid duplicate gifts without ever spoiling surprises.

## Official MCP Server (Model Context Protocol)

Blssit hosts an official remote **Streamable HTTP MCP server** so AI assistants (Claude, ChatGPT Connectors, Antigravity, Cursor, VS Code Copilot, Claude Code) have full Blssit account control: profile & public handle, wishlists, wishes & Trash, URL scraping, friends/following, BlssFeed, notifications, and private gift reservations.

- **MCP Endpoint:** https://app.blssit.com/api/mcp
- **Transport:** Streamable HTTP (JSON-RPC 2.0, protocols `2025-06-18`, `2025-03-26`, `2024-11-05`)
- **Authentication (connect once — persistent access):**
  - **OAuth 2.1 (PKCE S256 + Dynamic Client Registration):** Recommended for Claude & ChatGPT — point the client at https://app.blssit.com/api/mcp and approve once. Includes 30-day access tokens and **365-day rolling refresh tokens** so users do not have to log in again between seasons.
  - **Personal API Keys (`Bearer blss_pat_...`)**: Non-expiring tokens created & revoked anytime at https://app.blssit.com/profil#mcp.
- **Discovery Metadata:**
  - MCP Server Card: https://app.blssit.com/.well-known/mcp/server-card.json
  - Alternate Card: https://app.blssit.com/.well-known/mcp.json
  - OAuth Protected Resource (RFC 9728): https://app.blssit.com/.well-known/oauth-protected-resource
  - OAuth Authorization Server (RFC 8414): https://app.blssit.com/.well-known/oauth-authorization-server

## Zero-Leak Privacy Invariant

Reservation data on a user's **own** wishlists is strictly stripped at both the database and MCP layers. An AI assistant connected to Blssit can never reveal or infer who reserved gifts on the signed-in user's own lists, and `reserve_wish` rejects any attempt to reserve items on the user's own wishlist.

## Available MCP Tools (29)

- `get_my_profile` — Get the signed-in user's Blssit profile, preferred currency, birthday, clothing/shoe sizes, favorite colors, allergies, and interests.
- `list_my_wishlists` — List all active wishlists owned by the signed-in user, including titles, visibility, share URLs, and wish counts.
- `create_wishlist` — Create a new Blssit wishlist for the signed-in user and receive its shareable URL.
- `list_my_wishes` — List active wishes belonging to the signed-in user, optionally filtered by wishlistId or search query. Reservation details are never exposed for your own wishes.
- `add_wish` — Add a wish to one or more of the user's wishlists. If productUrl is given (with autoScrape true), automatically extracts title, description, price, currency, and product image from the store page.
- `update_wish` — Update fields (title, description, price, currency, productUrl, imageUrl, sizeVariant, priority, quantity, or wishlistIds) on an existing wish owned by the user.
- `delete_wish` — Move one of the signed-in user's wishes to Trash (soft delete).
- `list_friends` — List mutual friends and people the user follows on Blssit, with upcoming birthdays and visible wishlist counts.
- `get_friend_gift_profile` — Look up a friend by friendUid, @handle, or display name to get their visible wishlists and (if mutual friends) their sizes, favorite colors, allergies, interests, and birthday.
- `get_shared_wishlist` — View a shared wishlist by shareCode or full share URL, including owner gift details and wishes. For lists owned by others, also includes availability and reservation status.
- `list_my_reservations` — List all active gift reservations the signed-in user has made for friends and family.
- `reserve_wish` — Reserve a gift on someone else's shared wishlist to prevent duplicate gifts. Never allowed on the signed-in user's own wishlist.
- `cancel_reservation` — Release/cancel a gift reservation that the signed-in user created.
- `update_my_profile` — Update the signed-in user's Blssit profile: displayName, birthDate, preferredCurrency, language, clothing/shoe sizes, favorite colors, allergies, interests, or avatarUrl.
- `set_my_handle` — Check availability for or set/clear the signed-in user's public Blssit profile URL handle (https://www.blssit.com/<handle>).
- `update_wishlist` — Update an existing wishlist owned by the user (title, description, visibility, allowedViewerIds, color, icon, coverImageUrl, expiresAt, or regenerateShareCode).
- `delete_wishlist` — Delete a custom wishlist owned by the user and reassign any wishes solely on it to the user's default wishlist. Default and Trash lists cannot be deleted.
- `scrape_product_url` — Preview metadata (title, description, price, currency, brand, images, sizeVariant) extracted from any public webshop product URL without creating a wish.
- `list_trash` — List wishes in the signed-in user's Trash (soft-deleted wishes that can be restored or permanently deleted).
- `restore_wish` — Restore a soft-deleted wish from Trash back to active wishlists.
- `permanent_delete_wish` — Permanently delete a wish that is already in Trash (and clean up any hosted Blssit storage image). Move active wishes to Trash with delete_wish first.
- `empty_trash` — Permanently delete all wishes currently in the user's Trash. Requires confirm: true.
- `search_users` — Search for Blssit users by display name or @handle to discover friends and check follow status.
- `follow_user` — Follow another Blssit user by targetUid or @handle. Mutual follows become friends who can see friends-only wishlists and gift profiles.
- `unfollow_user` — Stop following another Blssit user by targetUid or @handle.
- `get_feed` — Get the BlssFeed of recent wishes from mutual friends or everyone the user follows.
- `list_notifications` — List the signed-in user's recent notifications (new followers, mutual friends, shared wishlists).
- `mark_notifications_read` — Mark either a specific notification (by notificationId) or all unread notifications (all: true) as read.
- `import_onskeskyen_wishlist` — Preview or import an entire shared wishlist from GoWish (gowish.com) or Ønskeskyen (onskeskyen.dk, onskeskyen.no, onskeskyen.se) into the user's Blssit account in one step.

## Built-in MCP Prompts (4)

- `onboard_and_import` — Get started on Blssit: import existing wishlists from GoWish (English) or Ønskeskyen (Danish) or other lists, set up gift sizes, and claim your public profile URL.
- `gift_ideas_for_friend` — Analyze a Blssit friend's wishlists, clothing sizes, favorite colors, allergies, and interests to recommend thoughtful gift ideas.
- `add_wishes_from_links` — Save one or more store product links into the user's Blssit wishlists automatically.
- `upcoming_birthdays_plan` — Review friends' upcoming birthdays, existing reservations, and unreserved wishes to plan gifts ahead.

## Onboarding Guidance for AI Assistants

When a user connects to Blssit MCP for the first time or has an empty account, check `get_my_profile` and `list_my_wishlists` and proactively offer to import existing wishlists: suggest **Ønskeskyen** for Danish users and **GoWish** for English users via `import_onskeskyen_wishlist`, or help them bring wishes from any other wishlist service using `add_wish`.

## Documentation & Pages

- [Blssit MCP Setup & Guide (English)](https://www.blssit.com/en/mcp): Connect Claude, ChatGPT, Antigravity, Cursor, and CLI clients.
- [Blssit MCP-opsætning (Dansk)](https://www.blssit.com/da/mcp): Dansk guide til AI-integration via Model Context Protocol.
- [Full MCP Tool & Schema Reference](https://www.blssit.com/llms-full.txt): Complete JSON schemas for all 29 tools and prompts.
- [Features Overview (EN)](https://www.blssit.com/en/features) & [Funktioner (DA)](https://www.blssit.com/da/funktioner).
