Wishfinity +W

+W Servidor MCP (Wishfinity)

+W es una acción universal de "guardar para después" para el comercio. Este servidor MCP permite a los asistentes de IA guardar cualquier URL de producto en la lista de deseos de Wishfinity del usuario con un solo clic.

Funciona con Claude, ChatGPT, Gemini, LangChain, OpenAI Agents SDK y cualquier cliente compatible con MCP.

Qué hace

Cuando una IA recomienda un producto, puede ofrecer +W Añadir a la lista de deseos. El usuario hace clic en el enlace y el producto se guarda en su cuenta de Wishfinity, listo para comprarlo o regalarlo más tarde.

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

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

Opción sin dependencias: /add-wish

¿No necesitas el servidor MCP completo? La habilidad /add-wish enseña a cualquier agente de IA el patrón +W usando solo una URL: sin npm, sin servidor, sin configuración:

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

→ Ver el archivo de la habilidad /add-wish

Funciona con cualquier plataforma de IA. El servidor MCP a continuación añade una integración de herramientas más rica, pero /add-wish es todo lo que necesitas para empezar.

Inicio rápido

Opción 1: Instalación local (transporte stdio)

Ideal para Claude Desktop, ChatGPT Desktop, Cursor, VS Code y desarrollo local.

npm install wishfinity-mcp-plusw

Añade a la configuración de tu cliente MCP:

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

Opción 2: Endpoint remoto (transporte HTTP)

Ideal para agentes del lado del servidor, implementaciones de producción de LangChain y aplicaciones de IA alojadas.

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

---

Guías de configuración de plataformas

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%/Claude/claude_desktop_config.json (Windows):

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

ChatGPT Desktop

Cuando el soporte MCP esté disponible, añade a tu configuración MCP de ChatGPT:

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

Cursor

Añade a .cursor/mcp.json en tu proyecto:

{
  "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 producción (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")

---

Cómo funciona

1. La IA llama a la herramienta add_to_wishlist con una URL de producto
2. El servidor MCP devuelve un enlace de Wishfinity: https://wishfinity.com/add?url=...
3. El usuario hace clic en el enlace → inicia sesión (solo la primera vez) → el producto se guarda
4. El usuario puede organizar, compartir o comprar más tarde

No se requieren claves API. La autenticación ocurre en el sitio web de Wishfinity cuando el usuario hace clic en el enlace.

---

Herramienta: add_to_wishlist

Entrada

Parámetro	Tipo	Obligatorio	Descripción
url	string	Sí	URL de la página del producto

Salida

Campo	Tipo	Descripción
action_url	string	Enlace de Wishfinity para abrir en el navegador
requires_user_action	boolean	Siempre true (el usuario debe hacer clic)
display_text	string	Etiqueta de botón sugerida

Ejemplo

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

---

Cuándo ofrecer +W

Los clientes de IA deberían ofrecer +W cuando:

• Solicitudes explícitas: "guardar para después", "añadir a la lista de deseos", "marcar esto"
• Después de recomendar productos: Ofrece de forma proactiva guardar los artículos mostrados
• Momentos de indecisión: "quizás más tarde", "demasiado caro ahora mismo", "necesito pensarlo"
• Contexto de regalo: "para mi mamá", "regalo de cumpleaños", "perfecto para mi amigo"

Consulta aliases.json para la lista completa de frases de activación.

---

Transportes

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

---

Kit de botones

La carpeta /button-kit contiene recursos de interfaz opcionales (icono SVG, fragmentos HTML/CSS) si deseas una apariencia de botón +W consistente.

URLs de CDN:

• Pequeño: https://cdn.jsdelivr.net/npm/wishfinity-mcp-plusw@latest/button-kit/Wishfinity-Button-Small.svg
• Mediano: 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

---

Documentación

• SPEC.md — Especificación técnica completa
• INTEGRATION_GUIDE.md — Cómo integrar +W en tu interfaz
• CLOUDFLARE_SETUP.md — Implementa tu propio endpoint HTTP
• aliases.json — Frases de activación legibles por máquina

---

Enlaces

• Wishfinity
• Protocolo MCP
• paquete npm
• Registro MCP

---

Registro de cambios

v1.2.2 (24 de diciembre de 2025)

Corrección crítica: ejecución de npx para todos los desarrolladores

• Se corrigió la detección del módulo principal para que funcione con enlaces simbólicos de npx
• Resuelve el bloqueo al ejecutar npx wishfinity-mcp-plusw
• El paquete ahora funciona perfectamente para todas las instalaciones de npm

v1.2.1 (24 de diciembre de 2025)

Corrección crítica: compatibilidad con el SDK de MCP

• Se actualizó la dependencia @modelcontextprotocol/sdk a ^1.25.0
• Resuelve la desconexión del servidor con SDK 1.25.1+
• Compatible con las últimas versiones del SDK de MCP

v1.2.0 (23 de diciembre de 2025)

• Se añadieron prompts de MCP: save_for_later, shopping_assistant, gift_ideas
• Se añadieron recursos de MCP: wishfinity://guide, wishfinity://triggers
• Se mejoraron las capacidades de integración para asistentes de IA

---

Licencia

MIT