Ration Pantry Management
MCP de cozinha nativa em IA — inventário de despensa, receitas com ingredientes disponíveis, planos de refeições e listas de compras com OAuth e mais de 35 ferramentas. Gratuito para começar.
Documentação
Repositório: gitlab.com/mayutic/ration/application — hospeda o Ration, um aplicativo de gestão de cozinha com IA, e seu servidor MCP dedicado (mcp.ration.mayutic.com).
Servidor MCP do Ration
Gestão de cozinha com IA para o seu assistente — inventário de despensa ao vivo, receitas a partir do estoque, planos de refeições semanais e listas de compras. Conectividade com IA via MCP (Model Context Protocol) permite que Claude, Cursor, ChatGPT e outros agentes leiam e atualizem sua cozinha com consentimento OAuth escopado — mesmos dados do aplicativo web, sem cópia paralela.
Página inicial: ration.mayutic.com · Conectar: ration.mayutic.com/connect · Comece grátis — sem necessidade de cartão de crédito.
O ciclo completo de cozinha para sua IA
A maioria dos aplicativos de cozinha faz você manter a planilha. O Ration fecha o ciclo:
Cargo (despensa) → Galley (receitas) → Manifest (plano de refeições) → Supply (lista de compras) → retorna ao Cargo.
Seu cliente MCP opera os mesmos dados que você vê no aplicativo web — não uma cópia paralela. A correspondência semântica vincula ingredientes de receitas a itens da despensa mesmo quando os nomes diferem ("2% milk" vs "whole milk 2%"). Ferramentas cientes de validade ajudam você a cozinhar o que tem antes que estrague.
Grátis para começar: 35 itens de despensa, 15 receitas, 3 listas de compras, acesso MCP completo e 12 créditos de boas-vindas para novas contas humanas. Atualize para Crew Member (€2/mês ou €12/ano) para capacidade ilimitada, compartilhamento doméstico e links de convite.
Mesmo prompt, melhor resposta
Sem o Ration
"O que posso preparar hoje à noite?"
Seu assistente adivinha. Ele não sabe o que está na sua geladeira, o que expirou ontem ou o que está no plano de quinta-feira.
Com o Ration MCP
"O que posso comer hoje à noite que se encaixa nas minhas metas de calorias?"
get_nutrition_summary retorna vsGoal restantes (dia UTC — não subtraia você mesmo). match_meals inclui nutrição compacta por porção e maxEnergyKcal opcional. Faça perguntas de acompanhamento: agende hoje à noite no Manifest ou faça um Quick Eat de um lanche.
"O que posso cozinhar hoje à noite com o que está no Cargo?"
match_meals retorna receitas classificadas pelo que você realmente pode cozinhar — com lacunas listadas para qualquer item ausente. Faça perguntas de acompanhamento: adicione itens ausentes ao Supply, agende uma refeição no Manifest, deduza ingredientes depois de cozinhar.
O que você pode dizer
| Prompt | O que acontece |
|---|---|
| "Como está minha cozinha?" | get_kitchen_summary |
| "O que cozinhei na semana passada?" | get_kitchen_events / get_kitchen_stats |
| "Liste minha despensa e o que expira esta semana." | list_inventory + get_expiring_items |
| "O que já expirou na minha despensa?" | get_expired_items |
| "Quais refeições posso fazer com o que temos?" | match_meals (correspondência estrita ou parcial; nutrição compacta quando conhecida) |
| "O que posso comer hoje à noite que se encaixa nas minhas metas de calorias?" | get_nutrition_summary (vsGoal) → match_meals com maxEnergyKcal |
| "Planeje jantares até sexta-feira e adicione qualquer item ausente à lista." | propose_manifest_plan → commit_manifest_plan → sync_supply_from_selected_meals |
| "Cozinhamos sopa de lentilha para quatro — atualize o inventário." | consume_meal deduz ingredientes via correspondência semântica |
| "Adicione ovos e manteiga à lista de compras." | add_supply_item |
| "Comprei tudo na lista — marque como comprado." | mark_supply_purchased_bulk |
| "Analise este recibo e adicione novos itens ao Cargo." | Agente analisa o texto → preview_inventory_import → apply_inventory_import (sem créditos de IA do Ration) |
| "Acabei de comer uvas." | quick_eat_cargo (cria uma linha ausente, lanche no Manifest, ingestão privada opcional) |
| "Importe esta receita do Instagram." | Não é um scrape do MCP. O cliente extrai texto da legenda/página → create_meal, ou Importação Nativa do Galley |
Chamadas de ferramentas MCP são determinísticas e não consomem créditos do Ration. Análise de recibos e extração de receitas de texto colado são executadas no seu LLM; o Ration ingere itens estruturados. Escaneamento visual e importação por URL no aplicativo web/iOS usam pacotes de crédito opcionais. O Copilot Ask são as mesmas ferramentas de cozinha mais um medidor de tokens de conversa.
Por que o Ration MCP é diferente
- Operações de cozinha em ciclo fechado — inventário, receitas, plano e lista de compras em um único sistema (não quatro aplicativos).
- Mais de 35 ferramentas MCP — escopos 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), incluindo resumo/metas de nutrição opcionais e Quick Eat quando os sinalizadores estão ativados. - OAuth em primeiro lugar — cole uma URL; login no navegador; revogue a qualquer momento em Hub → Configurações → Agentes Conectados.
- Auto-registro de agentes — agentes autônomos podem provisionar uma cozinha via
auth.mdantes de um humano se cadastrar. - Escopo doméstico — uma organização por concessão; selecione a casa correta no consentimento.
- Hospedado na borda — Cloudflare Workers, D1, pesquisa semântica Vectorize.
Conecte-se em cerca de 2 minutos
OAuth (recomendado)
-
No seu cliente MCP, adicione a URL do servidor:
https://mcp.ration.mayutic.com/mcp -
Complete o login no navegador, selecione sua casa e aprove os escopos.
-
Pergunte: "Liste minha despensa do Ration."
Funciona com: Cursor · Claude Desktop · Claude Code · ChatGPT desktop · Zed · qualquer cliente MCP com descoberta OAuth 2.1
Configuração em um clique: ration.mayutic.com/connect
Avançado: chave de API
Crie uma chave de API da organização com escopos mcp:* em Hub → Configurações → Chaves de API. Use um cabeçalho Bearer ou ponte mcp-remote. Consulte a documentação da API.
Agentes autônomos (onboarding agente-primeiro)
Seu cliente MCP pode provisionar uma cozinha sem cadastro humano:
- Leia auth.md para o contrato de registro e reivindicação.
POST /api/agent/authcom{ "type": "anonymous" }— retorna uma chave de API de escrita total, URL de reivindicação e endpoint MCP (uma vez).- Configure o MCP com a chave retornada como cabeçalho Bearer.
- O humano reivindica via OTP em ration.mayutic.com/connect/claim quando estiver pronto.
Passo a passo completo com configuração específica do cliente (Claude, Cursor, ChatGPT, Goose): Onboarding MCP Agente-Primeiro.
Referência de ferramentas MCP
Todas as ferramentas são escopadas para a casa autorizada. Chamadas MCP não consomem créditos do Ration. Ferramentas destrutivas exigem confirm: true.
Leitura e conta
| Ferramenta | Escopo | Descrição |
|---|---|---|
get_context | mcp:read | Retorna id da organização, escopos, nível/uso/créditos da cozinha/últimaAtividade, capacidades, próximas ações sugeridas e temporal (hojeUTC, hora do servidor, semântica de validade). Seguro chamar primeiro. |
search_ingredients | mcp:read | Pesquisa semântica de despensa por significado — encontre itens sem saber o nome exato. |
list_inventory | mcp:read | Lista de despensa paginada por cursor (padrão 100, máximo 200). Filtro de domínio opcional, expiresBefore / expiresAfter UTC e sortBy: expiresAt. Inclui nutrition quando presente. |
get_cargo_item | mcp:read | Busca um item de despensa por id (tags, validade, campos personalizados, nutrição quando presente). |
get_kitchen_summary | mcp:read | Instantâneo operacional em uma chamada (cargo, manifest, supply, nível/créditos). manifestDays opcional (1–7). |
get_kitchen_events | mcp:read | Linha do tempo do Flight Recorder de cozimentos, docks, expirações e jettisons (filtrável, paginado). |
get_kitchen_stats | mcp:read | Agregados do Flight Recorder para um período (7d/30d/90d/365d). |
get_expiring_items | mcp:read | Lista itens que expiram dentro de N dias corridos UTC (padrão é o expirationAlertDays do usuário). |
get_expired_items | mcp:read | Lista itens cuja data de validade é anterior a hoje (UTC). daysBack opcional (padrão 30). |
list_meals | mcp:read | Lista de receitas paginada por cursor. Defina includeIngredients: false para um índice leve. |
match_meals | mcp:read | Encontra receitas cozinháveis a partir da despensa atual — strict ou delta. Adiciona allergenFlags quando os alérgenos do usuário estão configurados. |
get_meal_plan | mcp:read | Entradas do plano de refeições semanal por data e slot (cookedAt/consumedAt; personalIntake quando os sinalizadores de nutrição permitem; gramsPerServing é a massa de ingredientes da receita por porção quando conhecida). |
get_supply_list | mcp:read | Lista de compras ativa com ids de itens para atualizações e alternância de compra. |
get_user_preferences | mcp:read | Alérgenos, dias de alerta de validade, tema, padrões do manifest e outras configurações do usuário. |
update_user_preferences | mcp:preferences:write | Atualiza configurações do usuário (alérgenos, alertas, tema). Apenas os campos fornecidos são alterados. |
get_nutrition_summary | mcp:nutrition:read | Totais diários de ingestão pessoal do chamador (energia/macros/fibra opcional) para um intervalo from/to UTC (requer nutrition-goals ou nutrition-manifest). Quando nutrition-cross-org-diary está ativado, inclui todas as cozinhas em que o usuário registrou — não nutrição doméstica. Leitura do agente auditada. |
list_nutrition_intakes | mcp:nutrition:read | Linhas de ingestão pessoal do chamador para um intervalo UTC (paginação por cursor; rótulos de cozinha quando presentes). Entre organizações quando nutrition-cross-org-diary está ativado. Leitura do agente auditada. |
set_nutrition_goal | mcp:nutrition:write | Upsert idempotente de metas diárias pessoais de energia/macros/fibra usando operationKey; o consentimento já deve estar ativo no Ration. Não é aconselhamento médico. |
clear_nutrition_goal | mcp:nutrition:write | Fechamento idempotente de metas abertas usando operationKey. Requer confirm: true + aprovação do host. |
log_manifest_intake | mcp:nutrition:write | Eat privado atômico para 1–50 entradas preparadas (operationKey + idempotencyKey por item). Porções: servings (0,01–100) ou amount+unit (serving/g/oz) quando gramsPerServing está presente. Chamadas com múltiplas entradas precisam de aprovação do host. O consentimento já deve estar ativo no Ration. |
clear_manifest_intake | mcp:nutrition:write | Anulação suave atômica de ingestão pessoal usando operationKey. Requer confirm: true + aprovação do host. |
Inventário (Cargo)
| Ferramenta | Escopo | Descrição |
|---|---|---|
add_cargo_item | mcp:inventory:write | Adiciona um único item de despensa (qtd > 0). Substituição nutrition opcional; quando omitida e nutrition-engine está ativado, o USDA resolve automaticamente. Sem créditos; vetores preenchidos em segundo plano. Prefira ferramentas de importação para volume. |
update_cargo_item | mcp:inventory:write | Define campos absolutos (incluindo nutrition opcional). A quantidade pode ser 0 (mantida como lembrete de reposição). |
adjust_cargo_item | mcp:inventory:write | Alteração relativa de delta (ex.: -2 quando o usuário comeu 2). Limita em 0; mantém a linha. |
remove_cargo_item | mcp:inventory:write | Exclui permanentemente uma linha de despensa. Requer confirm: true. |
preview_inventory_import | mcp:inventory:write | Importação de recibo/volume em modo de teste — retorna previewToken e linhas de exemplo. Prefira ration://schemas/inventory-import para a forma. |
apply_inventory_import | mcp:inventory:write | Confirma uma importação pré-visualizada após confirmação no chat. Idempotente via idempotencyKey. |
preview_inventory_remove | mcp:inventory:write | Exclusões em massa do Cargo em modo de teste (prefira para 2+ itens). |
apply_inventory_remove | mcp:inventory:write | Confirma uma pré-visualização de remoção após confirmação no chat. Idempotente. |
import_inventory_csv | mcp:inventory:write | Analisa e aplica uma string CSV em uma única chamada (wrapper de conveniência). |
Galley (receitas)
| Ferramenta | Escopo | Descrição |
|---|---|---|
create_meal | mcp:galley:write | Crie uma receita a partir de dados estruturados. |
update_meal | mcp:galley:write | Atualize uma receita — ida e volta via list_meals → edite → passe o objeto completo. |
delete_meal | mcp:galley:write | Exclua uma receita. Requer confirm: true. Em cascata para ingredientes, tags e entradas de Manifest vinculadas. |
set_active_meals | mcp:galley:write | Defina a seleção ativa da Galley exatamente para esses mealIds. syncSupply opcional. |
clear_active_meals | mcp:galley:write | Limpe todas as seleções ativas de refeições. Requer confirm: true. |
consume_meal | mcp:galley:write + mcp:inventory:write | Cozinhe e deduza ingredientes da despensa. Quando cook-log-split estiver ativado, faz a ponte para Manifest Prepared (sem ingestão pessoal). Requer ambos os escopos. |
Manifest (plano de refeições)
| Ferramenta | Escopo | Descrição |
|---|---|---|
add_meal_plan_entry | mcp:manifest:write | Agende uma refeição em uma data e horário. |
commit_manifest_plan | mcp:manifest:write | Confirme um agendamento multi-entrada confirmado (opcionalmente sincronize o suprimento). |
update_meal_plan_entry | mcp:manifest:write | Ajuste data, horário, porções ou notas. Não é possível editar entradas consumidas. |
remove_meal_plan_entry | mcp:manifest:write | Remova uma entrada de plano agendada. |
cook_manifest_entries | mcp:manifest:write + mcp:inventory:write | Cook compartilhado (Cargo + Prepared). Requer nutrition-cook-log-split. Nunca registra ingestão. |
consume_manifest_entries | mcp:manifest:write + mcp:inventory:write | Consumo combinado legado. Recusado quando cook-log-split está ativado — use cook e depois log_manifest_intake. Requer ambos os escopos. |
Suprimento (lista de compras)
| Ferramenta | Escopo | Descrição |
|---|---|---|
add_supply_item | mcp:supply:write | Adicione uma linha à lista de compras ativa. |
update_supply_item | mcp:supply:write | Atualize nome, quantidade ou unidade em uma linha de suprimento. |
remove_supply_item | mcp:supply:write | Remova uma linha da lista de suprimentos. |
mark_supply_purchased_bulk | mcp:supply:write | Marque uma ou várias linhas de suprimento como compradas / não compradas. |
sync_supply_from_selected_meals | mcp:supply:write | Reconstrua a lista a partir do plano de refeições + seleções da Galley (compre apenas o delta). |
complete_supply_list | mcp:supply:write + mcp:inventory:write | Registre itens comprados na despensa e arquive a lista. Requer ambos os escopos. Requer confirm: true. |
Cartão do servidor: .well-known/mcp/server-card.json · Referência completa da API: docs/api
Preços
| Nível | Inclui |
|---|---|
| Grátis | 35 itens de despensa · 15 receitas · 3 listas de suprimentos · MCP + OAuth · auto-registro de agente |
| Crew Member | Capacidade ilimitada · convites para o lar · links compartilhados de Manifest/Suprimento · $2/mês ou $12/ano |
| Pacotes de créditos (opcional) | Leitura de recibo por IA, importação de receitas, geração de refeições, plano semanal por IA no web app — a partir de €1 |
MCP não mede créditos. Use o web app quando quiser recursos hospedados de visão/IA.
Detalhes do servidor MCP
| Campo | Valor |
|---|---|
| Nome | Ration |
| Endpoint | https://mcp.ration.mayutic.com/mcp |
| Transporte | Streamable HTTP (OAuth 2.1) |
| Categoria | Produtividade |
| Fonte | gitlab.com/mayutic/ration/application |
| Página inicial | ration.mayutic.com |
| Documento de listagem | ration.mayutic.com/mcp.md |
| Criado por | Mayutic |
Envio para mcpservers.org (copiar e colar)
- Nome do servidor: Ration
- Descrição curta: MCP de cozinha nativo para IA — inventário de despensa, receitas para cozinhar com o que tem, planos de refeições e listas de compras com OAuth e mais de 35 ferramentas. Grátis para começar.
- Link: https://ration.mayutic.com/mcp.md
- Categoria: Produtividade
Saiba mais
- Página inicial e cadastro
- Conecte seu agente
- Sua Cozinha Tem uma API (blog)
- O Problema dos Dados da Despensa (blog)
- REST API v1
Ration — gerencie sua cozinha pelo seu agente de IA.