wetaca-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wetaca-mcp what's on the menu for next week?"
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.
wetaca-mcp
Servidor MCP para gestionar tu Wetaca desde Claude Desktop, Cursor y cualquier cliente que hable stdio. Cubre la suscripción, el menú de la semana, las entregas, los pedidos, los cupones, las tarjetas regalo y el monedero.
No está afiliado a Wetaca. Es un proyecto independiente. No usa una API privada: lanza wetaca-cli, que a su vez habla con el mismo GraphQL que la web (api.wetaca.com).
No gestiona pagos ni tarjetas. Si hay un cobro pendiente, se paga en wetaca.com.
Créditos
La base es wetaca-cli (npm wetaca-cli, MIT), de Jorge Soler Padial (gorgueugr):
https://github.com/gorgueugr/wetaca-cli
Este paquete no reimplementa la API. Cada herramienta construye un comando de ese CLI y lo ejecuta con --format=json, --error-format=json y --no-input. Así el contrato (códigos de salida, confirmaciones, deriva del esquema) sigue siendo el del CLI instalado. La versión empaquetada es wetaca-cli@0.2.6. Si quieres usar otro binario —por ejemplo el wetaca global con el que iniciaste sesión— define WETACA_BIN.
Related MCP server: macro-cache
Requisitos
Node.js 20 o superior (el CLI admite Node 18; el SDK de MCP que usa este servidor pide 20).
Una sesión de Wetaca creada con el CLI. El servidor no pide la contraseña y no abre el navegador.
Instalación
Desde este repositorio:
npm install
npm run buildEl ejecutable queda en dist/index.js. El comando del paquete es wetaca-mcp.
Cuando el paquete esté publicado en npm:
npx -y wetaca-mcpPara iniciar sesión hace falta el comando wetaca, que viene de wetaca-cli (no de este paquete):
npm install -g wetaca-cli@0.2.6
wetaca doctorTambién vale npx wetaca-cli@0.2.6 doctor sin instalación global.
Autenticación
El servidor no guarda secretos y no tiene una herramienta de login. Reutiliza la sesión que ya creó el CLI.
Entra en wetaca.com con tu cuenta.
Abre las herramientas de desarrollo (F12) → Red → cualquier petición a
api.wetaca.com.Copia el valor del encabezado
authorization: Bearer …(solo el token, sin la palabra Bearer).En la terminal:
wetaca auth login --token <TOKEN>
wetaca auth statusEl CLI comprueba el token, pide las cookies de sesión a wetaca.com y las guarda en:
Linux y macOS:
$XDG_CONFIG_HOME/wetaca-clio~/.config/wetaca-cliWindows:
%USERPROFILE%\.config\wetaca-cli
Los secretos van a credentials.json (permisos solo para tu usuario). El resto, a config.json. A partir de ahí, el MCP usa esa misma carpeta: no hace falta volver a pegar el token.
También puedes pasar la sesión por el entorno del proceso MCP, sin escribirla en el repo:
WETACA_TOKENtiene prioridad sobre el fichero.WETACA_REFRESH_TOKENrenueva la sesión sin disco (pensado para CI).
No pongas esos valores en un mcp.json que vaya a git. Si los necesitas, ponlos solo en la configuración de usuario del cliente. No pegues el token en el chat: el modelo lo vería.
Si una herramienta responde auth_required (código de salida 3), la sesión no vale. Hay que repetir wetaca auth login en la terminal. El servidor no automatiza el navegador ni pide la contraseña de Google.
Otras formas de entrar (--cookies, --refresh-token) están en wetaca auth login --help y en el README de wetaca-cli. El camino recomendado es --token.
Claude Desktop
Archivo de configuración:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Con el repo ya compilado (sustituye la ruta):
{
"mcpServers": {
"wetaca": {
"command": "node",
"args": ["/RUTA/ABSOLUTA/al/repo/dist/index.js"]
}
}
}Cuando wetaca-mcp esté en npm:
{
"mcpServers": {
"wetaca": {
"command": "npx",
"args": ["-y", "wetaca-mcp"]
}
}
}El mismo JSON está en examples/claude-desktop.mcp.json. Reinicia Claude Desktop después de guardar.
Cursor
Configuración global en ~/.cursor/mcp.json, o solo para un proyecto en .cursor/mcp.json (ese fichero no debería llevar tokens).
{
"mcpServers": {
"wetaca": {
"command": "node",
"args": ["/RUTA/ABSOLUTA/al/repo/dist/index.js"]
}
}
}Con el paquete publicado:
{
"mcpServers": {
"wetaca": {
"command": "npx",
"args": ["-y", "wetaca-mcp"]
}
}
}Copia de partida: examples/cursor.mcp.json.
Para forzar el mismo wetaca con el que iniciaste sesión, añade env en ese JSON de usuario (no en el repositorio):
{
"mcpServers": {
"wetaca": {
"command": "node",
"args": ["/RUTA/ABSOLUTA/al/repo/dist/index.js"],
"env": {
"WETACA_BIN": "/ruta/al/ejecutable/wetaca"
}
}
}
}Seguridad de las herramientas
El modelo de seguridad es el del CLI (--dry-run / --yes), con un cierre extra donde el CLI no pregunta.
Tipo | Qué hace este servidor |
Lectura | Se ejecuta tal cual. |
Dry-run ( | Por defecto pasa |
Confirmación del CLI ( | Esos comandos no tienen |
Confirmación de este servidor ( | El CLI no pregunta. Aquí no se lanza el proceso hasta que |
confirm: true solo debe usarse cuando la persona ha pedido esa operación concreta y ya ha visto el resumen. La respuesta de un simulacro incluye agent_note para recordarlo.
Un valor de argumento no puede colarse como flag: los valores van en --clave=valor y los posicionales detrás de --. Un perfil llamado --yes no confirma la operación.
Los códigos de salida del CLI se conservan: 0 correcto, 1 inesperado, 2 uso o confirmación, 3 sesión, 4 red, 5 no encontrado, 6 la API rechazó la operación, 7 el contrato de Wetaca cambió (contract_drift).
Herramientas
La guía embebida del CLI es la herramienta wetaca_usage (wetaca skills get wetaca-usage). Léela antes de modificar la cuenta.
Herramienta | Comando del CLI | Efecto |
|
| Lectura |
|
| Lectura |
|
| Lectura |
|
| Exige |
|
| Lectura |
|
| Lectura |
|
| Exige |
|
| Exige |
|
| Lectura |
|
| Exige |
|
| Exige |
|
| Dry-run hasta |
|
| Lectura |
|
| Lectura |
|
| Dry-run hasta |
|
| Lectura |
|
| Lectura |
|
| Lectura |
|
| Dry-run hasta |
|
| Dry-run hasta |
|
| Lectura |
|
| Lectura |
|
| Dry-run hasta |
|
| Lectura |
|
| Dry-run hasta |
|
| Dry-run hasta |
|
| Lectura |
|
| Lectura |
|
| Dry-run hasta |
|
| Dry-run hasta |
|
| Lectura |
|
| Dry-run hasta |
|
| Lectura |
|
| Lectura |
|
| Lectura |
|
| Lectura |
|
| Exige |
Quedan fuera, porque el CLI no los hace o no encajan en un chat: login con token, autocompletado del shell, pagos, alta de cuenta, cambiar el método de pago y recargas programadas del monedero.
Variables de entorno
Variable | Uso |
| Ejecutable de wetaca, o ruta a su |
| Token de sesión. Tiene prioridad sobre el fichero. No lo subas al repo. |
| Renovación de sesión sin disco. |
| Carpeta de configuración, si no quieres la ruta XDG por defecto. |
| Perfil de sesión por defecto. Cada herramienta también acepta |
| La respeta wetaca-cli al buscar |
| Tiempo máximo de cada comando. Por defecto 60000. |
El proceso del CLI hereda el entorno del servidor MCP.
Desarrollo
npm install
npm testnpm test compila TypeScript y ejecuta los tests: el argv de cada herramienta, un cliente MCP real por stdio contra la guía embebida de wetaca-cli, y un wetaca falso que comprueba que cancelar un pedido no sale de dry-run y que cerrar sesión no arranca el CLI sin confirm.
npm run build
node dist/index.jsEso deja el servidor esperando JSON-RPC por stdin. No abre un puerto. Los logs van a stderr para no mezclarse con el protocolo.
Publicar en npm
El nombre wetaca-mcp estaba libre en el registro al crear este repo. Publicar es un paso aparte, con una cuenta de npm:
npm test
npm publish --access publicHasta entonces, los clientes tienen que apuntar a node y a dist/index.js.
Licencia
MIT. Ver LICENSE.
wetaca-cli también es MIT. Este proyecto no está afiliado a Wetaca.
Available Tools
37 toolswetaca_addresses_listListar direccionesCRead-onlyIdempotent
Equivale a wetaca addresses list. Direcciones guardadas. Solo lectura.
Inputs: debug, profile.
wetaca_addresses_removeBorrar direcciónADestructive
Equivale a wetaca addresses remove <id>. Borra una dirección que no esté en uso. Si es la de la suscripción o la de la semana, el CLI se niega: primero hay que asignar otra con wetaca_addresses_save. Por defecto --dry-run. confirm:true envía --yes.
Inputs: address_id (required), debug, confirm, profile.
wetaca_addresses_saveGuardar dirección de entregaADestructive
Equivale a wetaca addresses save. Crea la dirección y la asigna a la suscripción y a la próxima semana (el mismo flujo que la web: saveAddress, editDeliveryAccountInfo, editSuggestionDelivery). Obligatorios: street, number, zipcode, city. Opcionales: floor, notes, firstname, lastname, phone; si faltan, el CLI hereda los de la dirección actual. Por defecto --dry-run. Cada ejecución real crea una dirección nueva: no es idempotente. confirm:true envía --yes.
Inputs: city (required), number (required), street (required), zipcode (required), +8 more.
wetaca_auth_logoutCerrar sesiónADestructiveIdempotent
Equivale a wetaca auth logout. Borra el token guardado en el perfil local. El CLI no pregunta; este servidor no llama al CLI hasta que confirm sea true. Para volver a entrar hace falta wetaca auth login en la terminal.
Inputs: debug, confirm, profile.
wetaca_auth_statusEstado de la sesiónARead-onlyIdempotent
Equivale a wetaca auth status. Dice si la sesión del perfil es válida. Si authenticated es false o el motivo es auth_required, la persona tiene que ejecutar wetaca auth login en su terminal. No pidas ni pegues tokens, cookies ni contraseñas en el chat. Solo lectura.
Inputs: debug, profile.
wetaca_config_getLeer una claveARead-onlyIdempotent
Equivale a wetaca config get <clave>. Lee una clave con puntos, por ejemplo defaultProfile. Si la clave acaba en token, el CLI devuelve ***. Solo lectura.
Inputs: key (required), debug, profile.
wetaca_config_listVer configuraciónBRead-onlyIdempotent
Equivale a wetaca config list. Configuración pública del CLI. Los tokens no se muestran. Solo lectura.
Inputs: debug, profile.
wetaca_config_pathRuta de la configuraciónARead-onlyIdempotent
Equivale a wetaca config path. Rutas de config.json y credentials.json. No devuelve el contenido de los secretos. Solo lectura.
Inputs: debug, profile.
wetaca_config_setCambiar configuraciónADestructiveIdempotent
Equivale a wetaca config set <clave> <valor>. Escribe config.json. El CLI no pregunta y rechaza las claves que acaban en token (el token solo entra con wetaca auth login). Este servidor no llama al CLI hasta que confirm sea true. Los valores true y false se guardan como booleanos, igual que en el CLI.
Inputs: key (required), value (required), debug, confirm, +1 more.
wetaca_deliveries_nextPróximas entregasARead-onlyIdempotent
Equivale a wetaca deliveries next. Sugerencias y pedidos pendientes, con los ids que usan wetaca_orders_cancel. Si nextPaymentPendingOrder no es null, hay un pago pendiente: este servidor no lo cobra; se paga en wetaca.com. Solo lectura.
Inputs: debug, profile.
wetaca_deliveries_optionsFranjas de entregaARead-onlyIdempotent
Equivale a wetaca deliveries options. Franjas horarias disponibles para el código postal de la suscripción, o para el zipcode que pases. Marca cuál es la actual. Solo lectura. El id se usa en wetaca_deliveries_set_option.
Inputs: debug, profile, zipcode.
wetaca_deliveries_set_optionCambiar franjaADestructive
Equivale a wetaca deliveries set-option <id>. Cambia la franja de entrega de la suscripción y de la próxima semana. El id sale de wetaca_deliveries_options. Por defecto --dry-run. confirm:true envía --yes.
Inputs: option_id (required), debug, confirm, profile.
wetaca_dish_showFicha de un platoARead-onlyIdempotent
Equivale a wetaca dish show <slug>. Detalle e ingredientes de un plato. El slug sale de wetaca_menu_list. Solo lectura.
Inputs: slug (required), debug, profile.
wetaca_doctorDiagnósticoARead-onlyIdempotent
Equivale a wetaca doctor. Comprueba Node, si api.wetaca.com responde y si hay sesión. Hace una petición de red de diagnóstico. No modifica la cuenta.
Inputs: debug, profile.
wetaca_giftcards_redeemCanjear tarjeta regaloADestructive
Equivale a wetaca giftcards redeem <CODE>. Ingresa el saldo de una tarjeta regalo en el monedero. No es un pago con tarjeta bancaria. Por defecto --dry-run. confirm:true envía --yes.
Inputs: code (required), debug, confirm, profile.
wetaca_giftcards_showLímites de tarjeta regaloARead-onlyIdempotent
Equivale a wetaca giftcards show. Importes mínimo y máximo de las tarjetas regalo. Solo lectura. No muestra ni cobra tarjetas de pago.
Inputs: debug, profile.
wetaca_meResumen de la cuentaARead-onlyIdempotent
Equivale a wetaca me. Resumen de cliente, estado de la suscripción y saldo del monedero. Solo lectura. No muestra tarjetas.
Inputs: debug, profile.
wetaca_orders_cancelCancelar pedidoADestructive
Equivale a wetaca orders cancel <id>. Cancela un pedido confirmado y devuelve el importe. El id sale de wetaca_deliveries_next (pendientes) o wetaca_orders_list (historial). Por defecto --dry-run, sin efectos. confirm:true envía --yes y cancela de verdad. No toca tarjetas ni pagos pendientes.
Inputs: order_id (required), debug, confirm, profile.
wetaca_orders_listHistorial de pedidosBRead-onlyIdempotent
Equivale a wetaca orders list. Pedidos anteriores. limit por defecto 10 en el CLI; offset por defecto 0. Solo lectura.
Inputs: debug, limit, offset, profile.
wetaca_orders_showDetalle de pedidoBRead-onlyIdempotent
Equivale a wetaca orders show <id>. Detalle de un pedido numérico. Solo lectura.
Inputs: order_id (required), debug, profile.
wetaca_profiles_listListar perfilesBRead-onlyIdempotent
Equivale a wetaca profiles list. Perfiles de la suscripción (id, nombre, menú). Solo lectura.
Inputs: debug, profile.
wetaca_profiles_pausePausar perfilADestructive
Equivale a wetaca profiles pause <id|nombre>. Deja de enviar tuppers a ese perfil. Acepta el id o el nombre. Por defecto --dry-run. confirm:true envía --yes.
Inputs: profile_ref (required), debug, confirm, profile.
wetaca_profiles_resumeReanudar perfilAIdempotent
Equivale a wetaca profiles resume <id|nombre>. Vuelve a activar un perfil pausado. Por defecto --dry-run. confirm:true envía --yes.
Inputs: profile_ref (required), debug, confirm, profile.
wetaca_subscription_pausePausar suscripciónADestructive
Equivale a wetaca subscription pause. Pausa la suscripción. Con weeks (entero ≥ 1) es una pausa de N semanas; sin weeks es indefinida y se reactiva con wetaca_subscription_resume. No tiene --dry-run. Sin confirm, el CLI prepara el resumen y sale con código 2 (confirmation_required) sin aplicar el cambio. confirm:true envía --yes. Opcional: feedback.
Inputs: debug, weeks, confirm, profile, +1 more.
wetaca_subscription_resumeReanudar suscripciónAIdempotent
Equivale a wetaca subscription resume. Reactiva una suscripción pausada. Si ya está activa, el CLI responde alreadyActive sin volver a activarla. No tiene --dry-run. Sin confirm, el CLI prepara el resumen y sale con código 2 (confirmation_required) sin aplicar el cambio. confirm:true envía --yes.
Inputs: debug, confirm, profile.
wetaca_subscription_showVer suscripciónARead-onlyIdempotent
Equivale a wetaca subscription show. Suscripción completa: perfiles, entrega, precio y próxima sugerencia. Solo lectura.
Inputs: debug, profile.
wetaca_suggestion_editEditar el menúADestructive
Equivale a wetaca suggestion edit --profile-suggestion ID --set "id:cantidad,...". Cambia los tuppers de un perfil en la próxima semana. Los ids salen de wetaca_suggestion_show o wetaca_menu_list. set es una lista productId:cantidad separada por comas; la cantidad es un entero ≥ 0. Por defecto --dry-run (devuelve wouldSend y no cambia el menú). confirm:true envía --yes. resume opcional se traduce a --resume=true|false, igual que el CLI.
Inputs: set (required), profile_suggestion (required), debug, resume, +2 more.
wetaca_suggestion_pauseSaltar la semanaADestructive
Equivale a wetaca suggestion pause. Salta la entrega de la próxima semana. La semana ya cobrada no se toca. No tiene --dry-run. Sin confirm, el CLI prepara el resumen y sale con código 2 (confirmation_required) sin aplicar el cambio. confirm:true envía --yes. Opcional: feedback y suggestion (id; si falta, el CLI usa la próxima).
Inputs: debug, confirm, profile, feedback, +1 more.
wetaca_suggestion_resumeReactivar la semanaAIdempotent
Equivale a wetaca suggestion resume. Vuelve a activar la entrega de la próxima semana si estaba saltada. También deshace el efecto de wetaca_vouchers_skip. No tiene --dry-run. Sin confirm, el CLI prepara el resumen y sale con código 2 (confirmation_required) sin aplicar el cambio. confirm:true envía --yes.
Inputs: debug, confirm, profile, suggestion.
wetaca_suggestion_showVer menú de la semanaARead-onlyIdempotent
Equivale a wetaca suggestion show. Menú de la próxima semana por perfil: precios, ventana de entrega y los ids (profileSuggestionId, productId) que hacen falta para wetaca_suggestion_edit. Solo lectura.
Inputs: debug, profile.
wetaca_usageGuía de usoARead-onlyIdempotent
Guía canónica para agentes, la misma que wetaca skills get wetaca-usage. Léela antes de cambiar el menú, la suscripción, un pedido, un cupón o una dirección. Incluye códigos de salida, reglas de confirmación y flujos típicos. Solo lectura y sin red.
Inputs: debug, profile.
wetaca_vouchers_applyAplicar cupónADestructive
Equivale a wetaca vouchers apply <CODE>. Aplica un cupón a la entrega de la próxima semana. Por defecto --dry-run. confirm:true envía --yes. No canjea tarjetas regalo: para eso está wetaca_giftcards_redeem.
Inputs: code (required), debug, confirm, profile, +1 more.
wetaca_vouchers_currentCupón de la semanaCRead-onlyIdempotent
Equivale a wetaca vouchers current. Cupón aplicado a la próxima semana, si hay alguno. Solo lectura.
Inputs: debug, profile.
wetaca_vouchers_listListar cuponesCRead-onlyIdempotent
Equivale a wetaca vouchers list. Cupones de la cuenta. Solo lectura.
Inputs: debug, profile.
wetaca_vouchers_skipNo usar cupónADestructive
Equivale a wetaca vouchers skip. AVISO del propio CLI: la API lo implementa como skipVoucher=true y TAMBIÉN pausa la entrega de la próxima semana, el mismo efecto que wetaca_suggestion_pause. Se deshace con wetaca_suggestion_resume. Por defecto --dry-run. confirm:true envía --yes.
Inputs: debug, confirm, profile, suggestion.
wetaca_wallet_showSaldo del monederoARead-onlyIdempotent
Equivale a wetaca wallet. Saldo del monedero, en céntimos y en euros. Solo lectura. No recarga el monedero ni gestiona pagos.
Inputs: debug, profile.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 37 tools
Each tool pairs a resource with a distinct action (orders_cancel vs orders_show, subscription_pause vs suggestion_pause vs profiles_pause) and the descriptions carefully spell out the scope differences, including the explicit warning that wetaca_vouchers_skip duplicates wetaca_suggestion_pause. The remaining confusion risk is concentrated in the three pause/resume families and dry-run-vs-confirm semantics, which are documented but still easy to misselect.
Every tool follows wetaca_<resource>_<verb> snake_case (wetaca_orders_list, wetaca_suggestion_edit, wetaca_addresses_remove), with the only deviations being single-command mirrors like wetaca_me, wetaca_doctor and wetaca_usage that still read clearly. The pattern is predictable enough that an agent can guess a tool name from the domain.
37 tools is heavy, but the surface mirrors a real CLI spanning orders, subscription, profiles, deliveries, menu, dishes, addresses, vouchers, gift cards, wallet, auth and config. A handful of peripheral entries (config_path, config_get, config_set, doctor, usage) add cognitive load without much agent value, pushing this above the comfortable 3-15 range.
Read plus lifecycle coverage is solid across every domain: orders list/show/cancel, subscription show/pause/resume, profiles list/pause/resume, suggestions show/edit/pause/resume, addresses list/save/remove, vouchers, gift cards, wallet. Notable gaps are the absence of address update (save always creates a new, non-idempotent record) and no profile creation or subscription (re)start, though agents can work around these.
Related MCP Connectors
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Every Canopy public API operation as a tool, run as you after a browser sign-in or on an API key.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
Related MCP Servers
- AlicenseCqualityCmaintenanceEnables AI agents and terminal users to manage Grocy household inventory, shopping lists, recipes, chores, and related household operations through MCP tools and a command-line interface.89MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to act as the memory and reasoning layer for nutrition tracking, letting users log meals from label photos or descriptions, save foods, recipes, meal-prep containers, and restaurant orders, record weigh-ins, and query targets, progress, and projections as tool calls. All writes are previewed with dry runs, checked for plausibility, and reversible.MIT
- AlicenseNot gradedqualityBmaintenanceEnables an assistant to query and manage a Grocy household's stock, shopping lists, recipes, meal plans, chores, tasks, batteries, equipment and master data through 76 typed MCP tools, with writes off by default and opt-in once enabled. Supports safe, reversible changes such as booking receipts into stock, ticking off shopping items and undoing stock transactions.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables Claude to manage orders, stock, purchase orders, pickwaves, and channel listings in a user's own e-commerce account through 104 MCP tools, with dry-run defaults for writes.MIT