Wishfinity +W

+W MCP Server (Wishfinity)

+W é uma ação universal de "salvar para depois" para o comércio. Este servidor MCP permite que assistentes de IA salvem qualquer URL de produto na lista de desejos do usuário no Wishfinity com um clique.

Funciona com Claude, ChatGPT, Gemini, LangChain, OpenAI Agents SDK e qualquer cliente compatível com MCP.

O que ele faz

Quando uma IA recomenda um produto, ela pode oferecer +W Add to Wishlist. O usuário clica no link e o produto é salvo na conta Wishfinity dele — pronto para comprar ou presentear depois.

User: "Find me a good espresso machine under $200"

AI: Here are 3 options...
    [+W Add to Wishlist] [View on Amazon]

Opção sem dependências: /add-wish

Não precisa do servidor MCP completo? A skill /add-wish ensina a qualquer agente de IA o padrão +W usando apenas uma URL — sem npm, sem servidor, sem configuração:

https://wishfinity.com/add?url={any_product_url}

→ Ver o arquivo da skill /add-wish

Funciona com qualquer plataforma de IA. O servidor MCP abaixo adiciona integração de ferramentas mais rica, mas /add-wish é tudo o que você precisa para começar.

Início rápido

Opção 1: Instalação local (transporte stdio)

Ideal para Claude Desktop, ChatGPT Desktop, Cursor, VS Code e desenvolvimento local.

npm install wishfinity-mcp-plusw

Adicione à configuração do seu cliente MCP:

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

Opção 2: Endpoint remoto (transporte HTTP)

Ideal para agentes no lado do servidor, implantações de produção com LangChain e aplicações de IA hospedadas.

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

---

Guias de configuração por plataforma

Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%/Claude/claude_desktop_config.json (Windows):

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

ChatGPT Desktop

Quando o suporte a MCP estiver disponível, adicione à sua configuração MCP do ChatGPT:

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

Cursor

Adicione em .cursor/mcp.json no seu projeto:

{
  "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"}]
    })

Para produção (transporte HTTP):

client = MultiServerMCPClient({
    "wishfinity": {
        "url": "https://wishfinity-mcp-plusw.wishfinity.workers.dev/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")

---

Como funciona

1. A IA chama a ferramenta add_to_wishlist com uma URL de produto
2. O servidor MCP retorna um link do Wishfinity: https://wishfinity.com/add?url=...
3. O usuário clica no link → faz login (somente na primeira vez) → o produto é salvo
4. O usuário pode organizar, compartilhar ou comprar depois

Nenhuma chave de API é necessária. A autenticação acontece no site do Wishfinity quando o usuário clica no link.

---

Ferramenta: add_to_wishlist

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
url	string	Sim	URL da página do produto

Saída

Campo	Tipo	Descrição
action_url	string	Link do Wishfinity para abrir no navegador
requires_user_action	boolean	Sempre true (o usuário deve clicar)
display_text	string	Rótulo sugerido para o botão

Exemplo

// 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"
}

---

Quando oferecer +W

Clientes de IA devem oferecer +W quando:

• Solicitações explícitas: "salvar para depois", "adicionar à lista de desejos", "marcar isto"
• Após recomendar produtos: Ofereça proativamente salvar os itens exibidos
• Momentos de indecisão: "talvez depois", "caro demais agora", "preciso pensar sobre isso"
• Contexto de presente: "para minha mãe", "presente de aniversário", "perfeito para meu amigo"

Consulte aliases.json para a lista completa de frases de gatilho.

---

Transportes

Transporte	Caso de uso	Endpoint
stdio	Clientes locais (Claude Desktop, Cursor, etc.)	npx wishfinity-mcp-plusw
HTTP	Agentes remotos/lado do servidor	https://wishfinity-mcp-plusw.wishfinity.workers.dev/mcp

---

Kit de botão

A pasta /button-kit contém recursos de UI opcionais (ícone SVG, trechos de HTML/CSS) se você quiser uma aparência consistente para o botão +W.

URLs de CDN:

• Pequeno: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Small.svg
• Médio: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Medium.svg
• Grande: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Large.svg

---

Documentação

• SPEC.md — Especificação técnica completa
• INTEGRATION_GUIDE.md — Como integrar +W à sua UI
• CLOUDFLARE_SETUP.md — Implante seu próprio endpoint HTTP
• aliases.json — Frases de gatilho legíveis por máquina

---

Links

• Wishfinity
• MCP Protocol
• npm package
• MCP Registry

---

Changelog

v1.2.2 (24 de dezembro de 2025)

Correção crítica: execução via npx para todos os desenvolvedores

• Corrigida a detecção do módulo principal para funcionar com symlinks do npx
• Resolve falha ao executar npx wishfinity-mcp-plusw
• O pacote agora funciona perfeitamente para todas as instalações npm

v1.2.1 (24 de dezembro de 2025)

Correção crítica: compatibilidade com o SDK MCP

• Dependência @modelcontextprotocol/sdk atualizada para ^1.25.0
• Resolve desconexão do servidor com SDK 1.25.1+
• Compatível com as versões mais recentes do SDK MCP

v1.2.0 (23 de dezembro de 2025)

• Adicionados prompts MCP: save_for_later, shopping_assistant, gift_ideas
• Adicionados recursos MCP: wishfinity://guide, wishfinity://triggers
• Capacidades de integração aprimoradas para assistentes de IA

---

Licença

MIT