Ration Pantry Management MCP Server

AI-native kitchen MCP — pantry inventory, cook-from-stock recipes, meal plans, and shopping lists with OAuth and 35+ tools. Free to start.

View on mayutic.com

Documentation

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 | |--------|----------------| | "List my pantry and what's expiring this week." | list_inventory + get_expiring_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) |

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.md before 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)

  1. In your MCP client, add server URL:
   https://mcp.ration.mayutic.com/mcp
  1. Complete browser sign-in, select your household, and approve scopes.
  2. 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:

  1. Read auth.md for the registration and claim contract.
  2. POST /api/agent/auth with { "type": "anonymous" } — returns a full-write API key, claim URL, and MCP endpoint (once).
  3. Configure MCP with the returned key as a Bearer header.
  4. 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, authorized scopes, capabilities, and suggested next actions. 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. | | get_cargo_item | mcp:read | Fetch one pantry item by id (tags, expiry, custom fields). | | get_expiring_items | mcp:read | List items expiring within N days (default 7). Plan rescue meals and reduce waste. | | 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 (fully cookable) or delta (partial + gaps). | | 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 pantry stock. No credits charged; vectors backfilled async. | | update_cargo_item | mcp:inventory:write | Update name, quantity, unit, expiry, domain, or tags. | | remove_cargo_item | mcp:inventory:write | Remove a pantry item. 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 | Mark cooked and deduct ingredients from pantry via semantic matching. |

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. |

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 | Dock purchased items into pantry and archive the list. 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

Ration — manage your kitchen through your AI agent.