How do I use wishfinity-mcp-plusw?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@wishfinity-mcp-plusw save this espresso machine to my wishlist https://amazon.com/dp/B0CMGZQJ9R" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

+W MCP Server (Wishfinity)

+W is a universal "save for later" action for commerce. This MCP server lets AI assistants save any product URL to a user's Wishfinity wishlist with one click.

Works with Claude, ChatGPT, Gemini, LangChain, OpenAI Agents SDK, and any MCP-compatible client.

npm version License: MIT

What it does

When an AI recommends a product, it can offer +W Add to Wishlist. The user clicks the link, and the product is saved to their Wishfinity account — ready for later purchase or gifting.

User: "Find me a good espresso machine under $200" AI: Here are 3 options... [+W Add to Wishlist] [View on Amazon]

Quick start

Option 1: Local installation (stdio transport)

Best for Claude Desktop, ChatGPT Desktop, Cursor, VS Code, and local development.

npm install wishfinity-mcp-plusw

Add to your MCP client configuration:

{ "mcpServers": { "wishfinity": { "command": "npx", "args": ["wishfinity-mcp-plusw"] } } }

Option 2: Remote endpoint (HTTP transport)

Best for server-side agents, LangChain production deployments, and hosted AI applications.

https://mcp.wishfinity.com/mcp

Or use the Cloudflare Workers URL:

https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

Platform Setup Guides

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{ "mcpServers": { "wishfinity": { "command": "npx", "args": ["wishfinity-mcp-plusw"] } } }

ChatGPT Desktop

When MCP support is available, add to your ChatGPT MCP configuration:

{ "mcpServers": { "wishfinity": { "command": "npx", "args": ["wishfinity-mcp-plusw"] } } }

Cursor

Add to .cursor/mcp.json in your project:

{ "mcpServers": { "wishfinity": { "command": "npx", "args": ["wishfinity-mcp-plusw"] } } }

LangChain

from langchain_mcp_adapters.client import MultiServerMCPClient from langchain.agents import create_agent async def main(): client = MultiServerMCPClient({ "wishfinity": { "command": "npx", "args": ["wishfinity-mcp-plusw"], "transport": "stdio", } }) tools = await client.get_tools() agent = create_agent("openai:gpt-4", tools) result = await agent.ainvoke({ "messages": [{"role": "user", "content": "Find me a coffee maker and save it to my wishlist"}] })

For production (HTTP transport):

client = MultiServerMCPClient({ "wishfinity": { "url": "https://mcp.wishfinity.com/mcp", "transport": "streamable_http", } })

OpenAI Agents SDK

from agents import Agent, Runner from agents.mcp import MCPServerStdio async def main(): async with MCPServerStdio( name="wishfinity", params={ "command": "npx", "args": ["wishfinity-mcp-plusw"], }, ) as server: agent = Agent( name="Shopping Assistant", instructions="Help users find products and save them to wishlists.", mcp_servers=[server], ) result = await Runner.run(agent, "Find a good gift for a coffee lover and save it") print(result.final_output)

Hugging Face Agents

from huggingface_hub import Agent agent = Agent( model="meta-llama/Llama-3.1-70B-Instruct", mcp_servers=[{ "command": "npx", "args": ["wishfinity-mcp-plusw"] }] ) response = agent.run("Find me running shoes under $150 and save to wishlist")

How it works

AI calls the add_to_wishlist tool with a product URL
MCP server returns a Wishfinity link: https://wishfinity.com/add?url=...
User clicks the link → logs in (first time only) → product is saved
User can organize, share, or purchase later

No API keys required. Authentication happens on Wishfinity's website when the user clicks the link.

Tool: `add_to_wishlist`

Input

Parameter	Type	Required	Description
`url`	string	Yes	Product page URL

Output

Field	Type	Description
`action_url`	string	Wishfinity link to open in browser
`requires_user_action`	boolean	Always `true` (user must click)
`display_text`	string	Suggested button label

Example

// Input { "url": "https://amazon.com/dp/B0EXAMPLE" } // Output { "action_url": "https://wishfinity.com/add?url=https%3A%2F%2Famazon.com%2Fdp%2FB0EXAMPLE", "requires_user_action": true, "display_text": "Open to add to Wishfinity" }

When to offer +W

AI clients should offer +W when:

Explicit requests: "save for later," "add to wishlist," "bookmark this"
After recommending products: Proactively offer to save shown items
Indecision moments: "maybe later," "too expensive right now," "need to think about it"
Gift context: "for my mom," "birthday gift," "perfect for my friend"

See aliases.json for the full list of trigger phrases.

Transports

Transport	Use Case	Endpoint
stdio	Local clients (Claude Desktop, Cursor, etc.)	`npx wishfinity-mcp-plusw`
HTTP	Remote/server-side agents	`https://mcp.wishfinity.com/mcp`

Button kit

The /button-kit folder contains optional UI assets (SVG icon, HTML/CSS snippets) if you want a consistent +W button appearance.

CDN URLs:

Small: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Small.svg
Medium: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Medium.svg
Large: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Large.svg

Documentation

SPEC.md — Full technical specification
INTEGRATION_GUIDE.md — How to integrate +W into your UI
CLOUDFLARE_SETUP.md — Deploy your own HTTP endpoint
aliases.json — Machine-readable trigger phrases

Changelog

v1.2.2 (December 24, 2025)

Critical Fix: npx execution for all developers

Fixed main module detection to work with npx symlinks
Resolves crash when running npx wishfinity-mcp-plusw
Package now works flawlessly for all npm installations

v1.2.1 (December 24, 2025)

Critical Fix: MCP SDK compatibility

Updated @modelcontextprotocol/sdk dependency to ^1.25.0
Resolves server disconnection with SDK 1.25.1+
Compatible with latest MCP SDK versions

v1.2.0 (December 23, 2025)

Added MCP prompts: save_for_later, shopping_assistant, gift_ideas
Added MCP resources: wishfinity://guide, wishfinity://triggers
Enhanced integration capabilities for AI assistants

License

MIT

wishfinity-mcp-plusw

+W MCP Server (Wishfinity)

What it does

Quick start

Option 1: Local installation (stdio transport)

Option 2: Remote endpoint (HTTP transport)

Platform Setup Guides

Claude Desktop

ChatGPT Desktop

Cursor

LangChain

OpenAI Agents SDK

Hugging Face Agents

How it works

Tool: `add_to_wishlist`

Input

Output

Example

When to offer +W

Transports

Button kit

Documentation

Links

Changelog

v1.2.2 (December 24, 2025)

v1.2.1 (December 24, 2025)

v1.2.0 (December 23, 2025)

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

+W MCP Server (Wishfinity)

What it does

Quick start

Option 1: Local installation (stdio transport)

Option 2: Remote endpoint (HTTP transport)

Platform Setup Guides

Claude Desktop

ChatGPT Desktop

Cursor

LangChain

OpenAI Agents SDK

Hugging Face Agents

How it works

Tool: add_to_wishlist

Input

Output

Example

When to offer +W

Transports

Button kit

Documentation

Links

Changelog

v1.2.2 (December 24, 2025)

v1.2.1 (December 24, 2025)

v1.2.0 (December 23, 2025)

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

Tool: `add_to_wishlist`