Ration Pantry Management
MCP de cocina nativo en IA — inventario de despensa, recetas con lo que tienes, planes de comidas y listas de compras con OAuth y más de 35 herramientas. Comienza gratis.
Documentación
Repositorio: gitlab.com/mayutic/ration/application — aloja Ration, una aplicación de gestión de cocina impulsada por IA, y su servidor MCP dedicado (mcp.ration.mayutic.com).
Servidor MCP de Ration
Gestión de cocina impulsada por IA para tu asistente — inventario de despensa en vivo, recetas para cocinar con lo que tienes, planes de comidas semanales y listas de compras. Conectividad de IA vía MCP (Protocolo de Contexto de Modelo) permite que Claude, Cursor, ChatGPT y otros agentes lean y actualicen tu cocina con consentimiento OAuth delimitado — los mismos datos que la aplicación web, sin copia paralela.
Página principal: ration.mayutic.com · Conectar: ration.mayutic.com/connect · Empieza gratis — no se requiere tarjeta de crédito.
El ciclo completo de cocina para tu IA
La mayoría de las aplicaciones de cocina te hacen a ti mantener la hoja de cálculo. Ration cierra el ciclo:
Cargo (despensa) → Galley (recetas) → Manifest (plan de comidas) → Supply (lista de compras) → regresa a Cargo.
Tu cliente MCP opera con los mismos datos que ves en la aplicación web — no una copia paralela. La coincidencia semántica vincula los ingredientes de las recetas con los artículos de la despensa incluso cuando los nombres difieren ("2% milk" vs "whole milk 2%"). Las herramientas conscientes de caducidad te ayudan a cocinar lo que tienes antes de que se eche a perder.
Gratis para empezar: 35 artículos de despensa, 15 recetas, 3 listas de suministros, acceso MCP completo y 12 créditos de bienvenida para cuentas humanas nuevas. Mejora a Crew Member (€2/mes o €12/año) para capacidad ilimitada, uso compartido del hogar y enlaces de invitación.
Misma pregunta, mejor respuesta
Sin Ration
"¿Qué puedo preparar esta noche?"
Tu asistente adivina. No sabe qué hay en tu refrigerador, qué caducó ayer ni qué hay planeado para el jueves.
Con Ration MCP
"¿Qué puedo comer esta noche que se ajuste a mis objetivos calóricos?"
get_nutrition_summary devuelve vsGoal restantes (día UTC — no restes tú mismo). match_meals incluye nutrición compacta por porción y maxEnergyKcal opcional. Haz preguntas de seguimiento: programa esta noche en Manifest, o come un snack rápido con Quick Eat.
"¿Qué puedo cocinar esta noche con lo que hay en Cargo?"
match_meals devuelve recetas clasificadas por lo que realmente puedes cocinar — con los faltantes listados para cualquier ingrediente que falte. Haz preguntas de seguimiento: agrega los artículos faltantes a Supply, programa una comida en Manifest, descuenta ingredientes después de cocinar.
Lo que puedes decir
| Pregunta | Qué sucede |
|---|---|
| "¿Cómo está mi cocina?" | get_kitchen_summary |
| "¿Qué cociné la semana pasada?" | get_kitchen_events / get_kitchen_stats |
| "Enumera mi despensa y lo que caduca esta semana." | list_inventory + get_expiring_items |
| "¿Qué caducó ya en mi despensa?" | get_expired_items |
| "¿Qué comidas puedo hacer con lo que tenemos?" | match_meals (coincidencias estrictas o parciales; nutrición compacta cuando se conoce) |
| "¿Qué puedo comer esta noche que se ajuste a mis objetivos calóricos?" | get_nutrition_summary (vsGoal) → match_meals con maxEnergyKcal |
| "Planea cenas hasta el viernes y agrega lo que falte a la lista." | propose_manifest_plan → commit_manifest_plan → sync_supply_from_selected_meals |
| "Cocinamos sopa de lentejas para cuatro — actualiza el inventario." | consume_meal descuenta ingredientes mediante coincidencia semántica |
| "Agrega huevos y mantequilla a la lista de compras." | add_supply_item |
| "Compré todo lo de la lista — márcalo como comprado." | mark_supply_purchased_bulk |
| "Analiza este recibo y agrega los artículos nuevos a Cargo." | El agente analiza el texto → preview_inventory_import → apply_inventory_import (sin créditos de IA de Ration) |
| "Acabo de comer uvas." | quick_eat_cargo (crea una línea faltante, snack en Manifest, ingesta privada opcional) |
| "Importa esta receta de Instagram." | No es un raspado de MCP. El cliente extrae el texto del pie de foto/página → create_meal, o Importación nativa de Galley |
Las llamadas a herramientas MCP son deterministas y no consumen créditos de Ration. El análisis de recibos y la extracción de recetas desde texto pegado se ejecutan en tu LLM; Ration ingiere artículos estructurados. El escaneo visual y la importación por URL en la aplicación web/iOS usan paquetes de créditos opcionales. Copilot Ask son las mismas herramientas de cocina más un medidor de tokens de conversación.
Por qué Ration MCP es diferente
- Operaciones de cocina de ciclo cerrado — inventario, recetas, plan y lista de compras en un solo sistema (no cuatro aplicaciones).
- Más de 35 herramientas MCP — alcances OAuth granulares (
mcp:read,mcp:inventory:write,mcp:galley:write,mcp:manifest:write,mcp:supply:write,mcp:preferences:write,mcp:nutrition:read,mcp:nutrition:write), incluidos resumen nutricional/objetivos opcionales y Quick Eat cuando las banderas están activadas. - OAuth primero — pega una URL; inicio de sesión en el navegador; revoca en cualquier momento en Hub → Configuración → Agentes Conectados.
- Autorregistro de agentes — los agentes autónomos pueden aprovisionar una cocina mediante
auth.mdantes de que un humano se registre. - Delimitado por hogar — una organización por concesión; elige el hogar correcto en el consentimiento.
- Alojado en el borde — Cloudflare Workers, D1, búsqueda semántica Vectorize.
Conéctate en unos 2 minutos
OAuth (recomendado)
-
En tu cliente MCP, agrega la URL del servidor:
https://mcp.ration.mayutic.com/mcp -
Completa el inicio de sesión en el navegador, selecciona tu hogar y aprueba los alcances.
-
Pregunta: "Enumera mi despensa de Ration."
Funciona con: Cursor · Claude Desktop · Claude Code · ChatGPT de escritorio · Zed · cualquier cliente MCP con descubrimiento OAuth 2.1
Configuración en un clic: ration.mayutic.com/connect
Avanzado: clave API
Crea una clave API de organización con alcances mcp:* en Hub → Configuración → Claves API. Usa un encabezado Bearer o el puente mcp-remote. Consulta la documentación de API.
Agentes autónomos (incorporación agente-primero)
Tu cliente MCP puede aprovisionar una cocina sin registro humano:
- Lee auth.md para el contrato de registro y reclamación.
POST /api/agent/authcon{ "type": "anonymous" }— devuelve una clave API de escritura completa, URL de reclamación y endpoint MCP (una vez).- Configura MCP con la clave devuelta como encabezado Bearer.
- El humano reclama mediante OTP en ration.mayutic.com/connect/claim cuando esté listo.
Guía completa con configuración específica por cliente (Claude, Cursor, ChatGPT, Goose): Incorporación MCP Agente-Primero.
Referencia de herramientas MCP
Todas las herramientas están delimitadas al hogar autorizado. Las llamadas MCP no consumen créditos de Ration. Las herramientas destructivas requieren confirm: true.
Lectura y cuenta
| Herramienta | Alcance | Descripción |
|---|---|---|
get_context | mcp:read | Devuelve id de organización, alcances, nivel/uso/créditos de cocina/últimaActividad, capacidades, próximas acciones sugeridas y temporal (hoyUtc, hora del servidor, semántica de caducidad). Seguro de llamar primero. |
search_ingredients | mcp:read | Búsqueda semántica en la despensa por significado — encuentra artículos sin saber el nombre exacto. |
list_inventory | mcp:read | Lista de despensa paginada con cursor (predeterminado 100, máximo 200). Filtro de dominio opcional, expiresBefore / expiresAfter UTC y sortBy: expiresAt. Incluye nutrition cuando está presente. |
get_cargo_item | mcp:read | Obtiene un artículo de despensa por id (etiquetas, caducidad, campos personalizados, nutrición cuando está presente). |
get_kitchen_summary | mcp:read | Instantánea operativa de una sola llamada (cargo, manifest, supply, nivel/créditos). manifestDays opcional (1–7). |
get_kitchen_events | mcp:read | Línea de tiempo del Registrador de Vuelo de cocciones, atraques, caducidades y expulsiones (filtrable, paginada). |
get_kitchen_stats | mcp:read | Agregados del Registrador de Vuelo para una ventana (7d/30d/90d/365d). |
get_expiring_items | mcp:read | Lista artículos que caducan dentro de N días calendario UTC (predeterminado al expirationAlertDays del usuario). |
get_expired_items | mcp:read | Lista artículos cuya fecha de caducidad es anterior a hoy (UTC). daysBack opcional (predeterminado 30). |
list_meals | mcp:read | Lista de recetas paginada con cursor. Establece includeIngredients: false para un índice ligero. |
match_meals | mcp:read | Encuentra recetas cocinables desde la despensa actual — strict o delta. Agrega allergenFlags cuando los alérgenos del usuario están configurados. |
get_meal_plan | mcp:read | Entradas del plan de comidas semanal por fecha y franja (cookedAt/consumedAt; personalIntake cuando las banderas de nutrición lo permiten; gramsPerServing es la masa de ingredientes de receta por porción cuando se conoce). |
get_supply_list | mcp:read | Lista de compras activa con ids de artículos para actualizaciones y alternancia de compra. |
get_user_preferences | mcp:read | Alérgenos, días de alerta de caducidad, tema, valores predeterminados de manifest y otros ajustes del usuario. |
update_user_preferences | mcp:preferences:write | Parchea ajustes del usuario (alérgenos, alertas, tema). Solo cambian los campos proporcionados. |
get_nutrition_summary | mcp:nutrition:read | Totales diarios de ingesta personal del llamante (energía/macros/fibra opcional) para un rango from/to UTC (requiere nutrition-goals o nutrition-manifest). Cuando nutrition-cross-org-diary está activado, incluye cada cocina donde el usuario registró — no nutrición del hogar. Lecturas de agente auditadas. |
list_nutrition_intakes | mcp:nutrition:read | Filas de ingesta personal del llamante para un rango UTC (paginado con cursor; etiquetas de cocina cuando están presentes). Entre organizaciones cuando nutrition-cross-org-diary está activado. Lecturas de agente auditadas. |
set_nutrition_goal | mcp:nutrition:write | Actualiza de forma idempotente objetivos diarios personales de energía/macros/fibra usando operationKey; el consentimiento ya debe estar activo en Ration. No es consejo médico. |
clear_nutrition_goal | mcp:nutrition:write | Cierra de forma idempotente objetivos abiertos usando operationKey. Requiere confirm: true + aprobación del host. |
log_manifest_intake | mcp:nutrition:write | Eat privado atómico para 1–50 entradas preparadas (operationKey + idempotencyKey por artículo). Porciones: servings (0.01–100) o amount+unit (serving/g/oz) cuando gramsPerServing está presente. Las llamadas con múltiples entradas necesitan aprobación del host. El consentimiento ya debe estar activo en Ration. |
clear_manifest_intake | mcp:nutrition:write | Anula de forma atómica y suave la ingesta personal usando operationKey. Requiere confirm: true + aprobación del host. |
Inventario (Cargo)
| Herramienta | Alcance | Descripción |
|---|---|---|
add_cargo_item | mcp:inventory:write | Agrega un solo artículo de despensa (cantidad > 0). nutrition opcional para anular; cuando se omite y nutrition-engine está activado, USDA se resuelve automáticamente. Sin créditos; vectores respaldados de forma asíncrona. Prefiere herramientas de importación para lotes. |
update_cargo_item | mcp:inventory:write | Establece campos absolutos (incluido nutrition opcional). La cantidad puede ser 0 (se mantiene como recordatorio de reabastecimiento). |
adjust_cargo_item | mcp:inventory:write | Cambio relativo de delta (p. ej., -2 cuando el usuario comió 2). Se limita a 0; conserva la fila. |
remove_cargo_item | mcp:inventory:write | Elimina permanentemente una línea de despensa. Requiere confirm: true. |
preview_inventory_import | mcp:inventory:write | Importación de recibo/lote en seco — devuelve previewToken y filas de muestra. Prefiere ration://schemas/inventory-import para la forma. |
apply_inventory_import | mcp:inventory:write | Confirma una importación previsualizada después de la confirmación en el chat. Idempotente mediante idempotencyKey. |
preview_inventory_remove | mcp:inventory:write | Eliminaciones masivas de Cargo en seco (prefiere para 2+ artículos). |
apply_inventory_remove | mcp:inventory:write | Confirma una previsualización de eliminación después de la confirmación en el chat. Idempotente. |
import_inventory_csv | mcp:inventory:write | Analiza y aplica una cadena CSV en una sola llamada (envoltorio de conveniencia). |
Galley (recetas)
| Herramienta | Alcance | Descripción |
|---|---|---|
create_meal | mcp:galley:write | Crea una receta a partir de datos estructurados. |
update_meal | mcp:galley:write | Actualiza una receta — ida y vuelta mediante list_meals → editar → pasar el objeto completo. |
delete_meal | mcp:galley:write | Elimina una receta. Requiere confirm: true. Se propaga a ingredientes, etiquetas y entradas vinculadas del Manifest. |
set_active_meals | mcp:galley:write | Establece la selección activa de Galley exactamente a estos mealIds. syncSupply opcional. |
clear_active_meals | mcp:galley:write | Borra todas las selecciones de comidas activas. Requiere confirm: true. |
consume_meal | mcp:galley:write + mcp:inventory:write | Cocina y descuenta ingredientes de la despensa. Cuando cook-log-split está activado, se conecta a Manifest Prepared (sin ingesta personal). Requiere ambos alcances. |
Manifest (plan de comidas)
| Herramienta | Alcance | Descripción |
|---|---|---|
add_meal_plan_entry | mcp:manifest:write | Programa una comida en una fecha y franja. |
commit_manifest_plan | mcp:manifest:write | Confirma un horario de múltiples entradas (opcionalmente sincroniza el suministro). |
update_meal_plan_entry | mcp:manifest:write | Modifica fecha, franja, porciones o notas. No se pueden editar entradas consumidas. |
remove_meal_plan_entry | mcp:manifest:write | Elimina una entrada programada del plan. |
cook_manifest_entries | mcp:manifest:write + mcp:inventory:write | Cocina compartida (Cargo + Prepared). Requiere nutrition-cook-log-split. Nunca registra ingesta. |
consume_manifest_entries | mcp:manifest:write + mcp:inventory:write | Consumo combinado heredado. Se rechaza cuando cook-log-split está activado — usa cook y luego log_manifest_intake. Requiere ambos alcances. |
Supply (lista de la compra)
| Herramienta | Alcance | Descripción |
|---|---|---|
add_supply_item | mcp:supply:write | Añade una línea a la lista de la compra activa. |
update_supply_item | mcp:supply:write | Actualiza nombre, cantidad o unidad en una línea de suministro. |
remove_supply_item | mcp:supply:write | Elimina una línea de la lista de suministro. |
mark_supply_purchased_bulk | mcp:supply:write | Marca una o varias líneas de suministro como compradas / no compradas. |
sync_supply_from_selected_meals | mcp:supply:write | Reconstruye la lista a partir del plan de comidas + selecciones de Galley (compra solo la diferencia). |
complete_supply_list | mcp:supply:write + mcp:inventory:write | Ingresa los artículos comprados en la despensa y archiva la lista. Requiere ambos alcances. Requiere confirm: true. |
Tarjeta del servidor: .well-known/mcp/server-card.json · Referencia completa de la API: docs/api
Precios
| Nivel | Incluye |
|---|---|
| Gratis | 35 artículos de despensa · 15 recetas · 3 listas de suministro · MCP + OAuth · auto-registro de agentes |
| Crew Member | Capacidad ilimitada · invitaciones de hogar · enlaces compartidos de Manifest/Supply · $2/mes o $12/año |
| Paquetes de créditos (opcional) | Escaneo de recibos con IA, importación de recetas, generación de comidas, plan semanal con IA en la aplicación web — desde 1 € |
MCP no mide créditos. Usa la aplicación web cuando quieras funciones de visión/IA alojadas.
Detalles del servidor MCP
| Campo | Valor |
|---|---|
| Nombre | Ration |
| Endpoint | https://mcp.ration.mayutic.com/mcp |
| Transporte | Streamable HTTP (OAuth 2.1) |
| Categoría | Productividad |
| Fuente | gitlab.com/mayutic/ration/application |
| Página principal | ration.mayutic.com |
| Documento de listado | ration.mayutic.com/mcp.md |
| Creado por | Mayutic |
Envío a mcpservers.org (copiar y pegar)
- Nombre del servidor: Ration
- Descripción breve: MCP de cocina nativo de IA — inventario de despensa, recetas para cocinar con lo disponible, planes de comidas y listas de la compra con OAuth y más de 35 herramientas. Gratis para empezar.
- Enlace: https://ration.mayutic.com/mcp.md
- Categoría: Productividad
Más información
- Página principal y registro
- Conecta tu agente
- Tu cocina tiene una API (blog)
- El problema de los datos de la despensa (blog)
- REST API v1
Ration — gestiona tu cocina a través de tu agente de IA.