# Wishfinity — Universal Social Wishlist

Wishfinity is the universal wishlist that lets users save products from any retailer,
share wishlists with friends and family, and get notified when items go on sale.

## +W Save URL (for AI agents and integrations)

To save a product to a user's Wishfinity wishlist, generate a URL using this pattern:

```
https://wishfinity.com/add?url=<URL_ENCODED_PRODUCT_URL>
```

Optional query parameters:
- `source=<surface_name>` — attribution for analytics (e.g., `source=chatgpt`)

### How it works

1. AI agent or integration generates the `/add?url=...` URL
2. User clicks the link, opening their browser
3. Wishfinity prompts sign-in if needed
4. Wishfinity scrapes product metadata from the URL
5. Product is saved to the user's wishlist
6. User is redirected to their new wish detail page

### Example

For a product at `https://www.amazon.com/dp/B0EXAMPLE`:

```
https://wishfinity.com/add?url=https%3A%2F%2Fwww.amazon.com%2Fdp%2FB0EXAMPLE&source=assistant
```

Note: The product URL MUST be URL-encoded (use `encodeURIComponent()` or equivalent).

## MCP Server

Wishfinity provides an MCP server for AI assistants:
- HTTP endpoint: https://mcp.wishfinity.com/mcp
- npm package: wishfinity-mcp-plusw

## Links

- Website: https://wishfinity.com
- Button documentation: https://info.wishfinity.com/button/manual
- App Store: https://apps.apple.com/us/app/wishfinity-universal-wishlist/id1178334610
- Google Play: https://play.google.com/store/apps/details?id=com.wishfinityinc.wishfinity