Ration Pantry Management
MCP dapur berbasis AI — inventaris dapur, resep berbasis stok, rencana makan, dan daftar belanja dengan OAuth serta 35+ alat. Gratis untuk memulai.
Dokumentasi
Repository: gitlab.com/mayutic/ration/application — hosts Ration, an AI-powered kitchen management app, and its dedicated MCP server (mcp.ration.mayutic.com).
Ration MCP Server
AI-powered kitchen management for your assistant — live pantry inventory, cook-from-stock recipes, weekly meal plans, and shopping lists. AI connectivity via MCP (Model Context Protocol) lets Claude, Cursor, ChatGPT, and other agents read and update your kitchen with scoped OAuth consent — same data as the web app, no shadow copy.
Homepage: ration.mayutic.com · Connect: ration.mayutic.com/connect · Start free — no credit card required.
The complete kitchen loop for your AI
Most kitchen apps make you maintain the spreadsheet. Ration closes the loop:
Cargo (pantry) → Galley (recipes) → Manifest (meal plan) → Supply (shopping list) → dock back into Cargo.
Your MCP client operates the same data you see in the web app — not a shadow copy. Semantic matching links recipe ingredients to pantry items even when names differ ("2% milk" vs "whole milk 2%"). Expiry-aware tools help you cook what you have before it spoils.
Free to start: 35 pantry items, 15 recipes, 3 supply lists, full MCP access. Upgrade to Crew Member ($2/month or $12/year) for unlimited capacity, household sharing, and invite links.
Same prompt, better answer
Without Ration
"What can I make tonight?"
Your assistant guesses. It does not know what is in your fridge, what expired yesterday, or what is on Thursday's plan.
With Ration MCP
"What can I cook tonight with what's in Cargo?"
match_meals returns recipes ranked by what you can actually cook — with gaps listed for anything missing. Ask follow-ups: add missing items to Supply, schedule a meal on Manifest, deduct ingredients after you cook.
What you can say
| Prompt | What happens |
|---|---|
| "How's my kitchen?" | get_kitchen_summary |
| "List my pantry and what's expiring this week." | list_inventory + get_expiring_items |
| "What already expired in my pantry?" | get_expired_items |
| "What meals can I make with what we have?" | match_meals (strict or partial matches) |
| "Plan dinners through Friday and add anything missing to the list." | get_meal_plan → bulk_add_meal_plan_entries → sync_supply_from_selected_meals |
| "We cooked lentil soup for four — update inventory." | consume_meal deducts ingredients via semantic matching |
| "Add eggs and butter to the shopping list." | add_supply_item |
| "I bought everything on the list — mark it purchased." | mark_supply_purchased |
| "Parse this receipt and add new items to Cargo." | Agent parses text → preview_inventory_import → apply_inventory_import (no Ration AI credits) |
| "I ate two cans of tuna." | adjust_cargo_item with delta: -2 (floors at 0; line stays for restock) |
MCP tool calls are deterministic and do not consume Ration credits. Receipt parsing runs in your LLM; Ration ingests structured items. Visual scan and AI meal generation in the web app use optional credit packs.
Why Ration MCP is different
- Closed-loop kitchen ops — inventory, recipes, plan, and shop list in one system (not four apps).
- 35+ MCP tools — granular OAuth scopes (
mcp:read,mcp:inventory:write,mcp:galley:write,mcp:manifest:write,mcp:supply:write). - OAuth-first — paste one URL; browser sign-in; revoke anytime in Hub → Settings → Connected Agents.
- Agent self-registration — autonomous agents can provision a kitchen via
auth.mdbefore a human signs up. - Household-scoped — one organization per grant; pick the correct household at consent.
- Edge-hosted — Cloudflare Workers, D1, Vectorize semantic search.
Connect in about 2 minutes
OAuth (recommended)
-
In your MCP client, add server URL:
https://mcp.ration.mayutic.com/mcp -
Complete browser sign-in, select your household, and approve scopes.
-
Ask: "List my Ration pantry."
Works with: Cursor · Claude Desktop · Claude Code · ChatGPT desktop · Zed · any MCP client with OAuth 2.1 discovery
One-click setup: ration.mayutic.com/connect
Advanced: API key
Create an organization API key with mcp:* scopes in Hub → Settings → API Keys. Use a Bearer header or mcp-remote bridge. See API docs.
Autonomous agents (agent-first onboarding)
Your MCP client can provision a kitchen without human signup:
- Read auth.md for the registration and claim contract.
POST /api/agent/authwith{ "type": "anonymous" }— returns a full-write API key, claim URL, and MCP endpoint (once).- Configure MCP with the returned key as a Bearer header.
- Human claims via OTP at ration.mayutic.com/connect/claim whenever ready.
Full walkthrough with client-specific setup (Claude, Cursor, ChatGPT, Goose): Agent-First MCP Onboarding.
MCP tools reference
All tools are scoped to the authorized household. MCP calls do not consume Ration credits. Destructive tools require confirm: true.
Read & account
| Tool | Scope | Description |
|---|---|---|
get_context | mcp:read | Return org id, scopes, kitchen tier/usage/credits/lastActivityAt, capabilities, suggested next actions, and temporal (todayUtc, server time, expiry semantics). Safe to call first. |
search_ingredients | mcp:read | Semantic pantry search by meaning — find items without knowing the exact name. |
list_inventory | mcp:read | Cursor-paginated pantry list (default 100, max 200). Optional domain filter, UTC expiresBefore / expiresAfter, and sortBy: expiresAt. |
get_cargo_item | mcp:read | Fetch one pantry item by id (tags, expiry, custom fields). |
get_kitchen_summary | mcp:read | Single-call operational snapshot (cargo, manifest, supply, tier/credits). Optional manifestDays (1–7). |
get_expiring_items | mcp:read | List items expiring within N UTC calendar days (defaults to user expirationAlertDays). |
get_expired_items | mcp:read | List items whose expiry date is before today (UTC). Optional daysBack (default 30). |
list_meals | mcp:read | Cursor-paginated recipe list. Set includeIngredients: false for a lightweight index. |
match_meals | mcp:read | Find cookable recipes from current pantry — strict or delta. Adds allergenFlags when user allergens are configured. |
get_meal_plan | mcp:read | Weekly meal plan entries by date and slot (breakfast, lunch, dinner, snack). |
get_supply_list | mcp:read | Active shopping list with item ids for updates and purchase toggles. |
get_user_preferences | mcp:read | Allergens, expiration alert days, theme, manifest defaults, and other user settings. |
update_user_preferences | mcp:preferences:write | Patch user settings (allergens, alerts, theme). Only provided fields change. |
Inventory (Cargo)
| Tool | Scope | Description |
|---|---|---|
add_cargo_item | mcp:inventory:write | Add a single pantry item (qty > 0). No credits; vectors backfilled async. Prefer import tools for bulk. |
update_cargo_item | mcp:inventory:write | Set absolute fields. Quantity may be 0 (kept as a restock reminder). |
adjust_cargo_item | mcp:inventory:write | Relative delta change (e.g. -2 when the user ate 2). Floors at 0; keeps the row. |
remove_cargo_item | mcp:inventory:write | Permanently delete a pantry line. Requires confirm: true. |
inventory_import_schema | mcp:read | JSON schema for bulk import fields, units, and row limits. |
preview_inventory_import | mcp:read | Dry-run receipt/bulk import — returns previewToken and per-row match/create/skip. |
apply_inventory_import | mcp:inventory:write | Commit a previewed import. Idempotent via idempotencyKey. |
import_inventory_csv | mcp:inventory:write | Parse and apply a CSV string in one call (convenience wrapper). |
Galley (recipes)
| Tool | Scope | Description |
|---|---|---|
create_meal | mcp:galley:write | Create a recipe from structured data. |
update_meal | mcp:galley:write | Update a recipe — round-trip via list_meals → edit → pass full object. |
delete_meal | mcp:galley:write | Delete a recipe. Requires confirm: true. |
toggle_meal_active | mcp:galley:write | Toggle a meal in the Galley active selection (drives supply sync). |
clear_active_meals | mcp:galley:write | Clear all active meal selections. Requires confirm: true. |
consume_meal | mcp:galley:write + mcp:inventory:write | Mark cooked and deduct ingredients from pantry via semantic matching. Requires both scopes. |
Manifest (meal plan)
| Tool | Scope | Description |
|---|---|---|
add_meal_plan_entry | mcp:manifest:write | Schedule a meal on a date and slot. |
bulk_add_meal_plan_entries | mcp:manifest:write | Add up to 50 plan entries in one atomic batch. |
update_meal_plan_entry | mcp:manifest:write | Patch date, slot, servings, or notes. Cannot edit consumed entries. |
remove_meal_plan_entry | mcp:manifest:write | Remove a scheduled plan entry. |
consume_manifest_entries | mcp:manifest:write + mcp:inventory:write | Mark manifest entries consumed and deduct ingredients from pantry. Requires both scopes. |
Supply (shopping list)
| Tool | Scope | Description |
|---|---|---|
add_supply_item | mcp:supply:write | Add a line to the active shopping list. |
update_supply_item | mcp:supply:write | Update name, quantity, or unit on a supply line. |
remove_supply_item | mcp:supply:write | Remove a supply list line. |
mark_supply_purchased | mcp:supply:write | Toggle purchased / unpurchased on a supply line. |
sync_supply_from_selected_meals | mcp:supply:write | Rebuild list from meal plan + Galley selections (buy only the delta). |
complete_supply_list | mcp:supply:write + mcp:inventory:write | Dock purchased items into pantry and archive the list. Requires both scopes. Requires confirm: true. |
Server card: .well-known/mcp/server-card.json · Full API reference: docs/api
Pricing
| Tier | Includes |
|---|---|
| Free | 35 pantry items · 15 recipes · 3 supply lists · MCP + OAuth · agent self-registration |
| Crew Member | Unlimited capacity · household invites · shared Manifest/Supply links · $2/mo or $12/yr |
| Credit packs (optional) | AI receipt scan, recipe import, meal generation, weekly AI plan in the web app — from $1 |
MCP does not meter credits. Use the web app when you want hosted vision/AI features.
MCP server details
| Field | Value |
|---|---|
| Name | Ration |
| Endpoint | https://mcp.ration.mayutic.com/mcp |
| Transport | Streamable HTTP (OAuth 2.1) |
| Category | Productivity |
| Source | gitlab.com/mayutic/ration/application |
| Homepage | ration.mayutic.com |
| Listing doc | ration.mayutic.com/mcp.md |
| Built by | Mayutic |
mcpservers.org submission (copy-paste)
- Server name: Ration
- Short description: AI-native kitchen MCP — pantry inventory, cook-from-stock recipes, meal plans, and shopping lists with OAuth and 35+ tools. Free to start.
- Link: https://ration.mayutic.com/mcp.md
- Category: Productivity
Learn more
- Homepage & signup
- Connect your agent
- Your Kitchen Has an API (blog)
- The Pantry Data Problem (blog)
- REST API v1
Ration — manage your kitchen through your AI agent.