wishfinity-mcp-plusw: Instructions file for Claude Code

Wishfinity +W MCP Server

Project Overview

This is an MCP (Model Context Protocol) server that adds wishlist functionality to AI assistants like Claude and ChatGPT. When users discuss products, the AI can offer to save items to their Wishfinity wishlist.

Current Version: 1.2.2 Status: ✅ Production — All tests passing, ready for GTM Last Tested: December 24, 2025

Quick Commands

# Install dependencies
npm install

# Run locally (stdio transport)
npm start

# Run Cloudflare Worker locally
npx wrangler dev

# Deploy to Cloudflare Workers
npx wrangler deploy

# Publish to npm
npm publish

# Run tests
npm test

Architecture

Dual Transport System

The server supports two transports:

1. stdio (local) — For Claude Desktop, ChatGPT Desktop, and local MCP clients

   • Entry: src/index.js
   • Config: Users add to their claude_desktop_config.json

2. HTTP (remote) — For web clients, hosted on Cloudflare Workers

   • Entry: src/worker.js
   • Endpoint: https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp
   • Health: https://wishfinity-mcp-plusw.wishfinity.workers.dev/health

Key Files

src/
├── index.js          # stdio entry point (npm package)
├── worker.js         # Cloudflare Worker entry point
├── server.js         # Core MCP server logic (shared)
└── tools/
    └── wishlist.js   # add_to_wishlist tool implementation

button-kit/           # SVG buttons for web embedding (NOT for chat display)
├── Wishfinity-Button-Small.svg
├── Wishfinity-Button-Medium.svg
├── Wishfinity-Button-Large.svg
└── README.md

Tool: add_to_wishlist

Purpose: Saves a product URL to the user's Wishfinity wishlist

Input:

{
  "url": "https://amazon.com/dp/B0D1XD1ZV3"
}

Output:

{
  "success": true,
  "action_url": "https://wishfinity.com/add?url=https%3A%2F%2Famazon.com%2Fdp%2FB0D1XD1ZV3",
  "message": "Click the link to save this product to your Wishfinity wishlist"
}

Trigger Behavior: The tool description is crafted to encourage AI assistants to proactively offer saving when users:

• Express indecision ("maybe I'll wait for a sale")
• Discuss gifts ("looking for a birthday gift")
• Ask to save/bookmark products
• Share product URLs for review