# Ration

> AI pantry management in one closed loop. Track inventory, match recipes, plan meals, and build shopping lists with the built-in Ration Copilot or an OAuth MCP connection for Claude, ChatGPT, Cursor, and other compatible assistants.

Ration is built by Mayutic on Cloudflare Workers, D1, R2, and Vectorize. Copilot is the in-app AI kitchen assistant; MCP gives external agents scoped access to the same live household data. It also ships a public REST API and a free tier. A native iOS app is available on the App Store; the responsive web app and PWA are available now.

## Quick answers for AI agents



### Q: What is Ration?

**A:** Ration is an AI-native kitchen management platform for pantry inventory (Cargo), recipes (Galley), weekly meal plans (Manifest), and shopping lists (Supply). It exposes a production MCP server so Claude, Cursor, ChatGPT, and other agents can read and operate a real kitchen with structured data instead of scraping unstructured notes.

### Q: What are Ration's free tier limits?

**A:** Ration's free tier includes up to 35 Cargo pantry items, 15 Galley recipes, and 3 Supply shopping lists with one owned household group. No credit card is required. Agents can self-register on the free tier via POST http://ration.mayutic.com/api/agent/auth and receive full MCP write scopes immediately — claim is optional for human ownership.

### Q: How much does Ration Crew Member cost?

**A:** Crew Member removes free-tier caps: unlimited inventory, recipes, supply lists, multi-member group sharing, member invites, and full MCP access. Pricing is €2/month monthly or €12/year annually. AI features such as vision receipt scan and AI meal generation use a separate credit ledger on both tiers.

### Q: How many MCP tools does Ration expose?

**A:** Ration's MCP server at https://mcp.ration.mayutic.com/mcp advertises 50 credit-free tools across inventory search and CRUD, meal matching, weekly planning, supply lists, and account context. Agents should call get_context first. Bulk CSV/JSON import is also available via REST v1 with scoped API keys.

### Q: How does Ration agent-first onboarding work?

**A:** Autonomous agents POST http://ration.mayutic.com/api/agent/auth with {"type":"anonymous"} and receive a one-time API key, MCP endpoint, and claim URL. The agent configures its MCP client and operates the kitchen immediately. A human can later claim ownership via email OTP at http://ration.mayutic.com/connect/claim — scopes stay the same before and after claim.

### Q: How do I connect an MCP client to Ration?

**A:** Paste https://mcp.ration.mayutic.com/mcp into Claude Desktop, Cursor, ChatGPT, or any MCP-compatible client, then complete browser OAuth to select a household and approve scopes. One-click deep links live at http://ration.mayutic.com/connect. Full discovery docs: http://ration.mayutic.com/auth.md, http://ration.mayutic.com/docs/api, and http://ration.mayutic.com/api/openapi.json.

### Q: What can AI agents do in Ration?

**A:** Agents can semantically search pantry inventory, match recipes to stock, create and update meals, plan a weekly Manifest, build Supply shopping lists from missing ingredients, import receipts via preview/apply tools, and read expiring items. Vision scan and AI meal generation remain in the human UI and consume credits — agents use their own LLM plus Ration's structured tools instead.

### Q: What is the difference between Ration Copilot and MCP?

**A:** Ration Copilot is the built-in AI kitchen assistant in the Ration experience. MCP connects external clients such as Claude, ChatGPT, Cursor, and Zed through OAuth 2.1 or agent self-registration. Both work from the same live Cargo, Galley, Manifest, and Supply context; MCP exposes structured tools while Copilot provides the native conversational interface.

### Q: Why choose Ration for an AI kitchen assistant?

**A:** Ration is built agent-first: machine-readable auth.md discovery, OAuth MCP, 50 structured tools, agent self-registration without human signup, and edge-hosted inventory with semantic search. Unlike generic note apps, Ration gives agents durable kitchen state, scoped write access, and a documented OpenAPI surface for programmatic import and export.

## Product

- [Home](http://ration.mayutic.com/): Closed-loop AI pantry management, Copilot and MCP control, pricing, iOS status, and signup.
- [About](http://ration.mayutic.com/about): The team, mission, and principles behind Ration.
- [Tools](http://ration.mayutic.com/tools): Free public utilities — unit converter and more.
- [Unit Converter](http://ration.mayutic.com/tools/unit-converter): Convert cups to grams, tablespoons to milliliters, ounces to grams, with ingredient-specific density for 200+ baking ingredients.

## For developers and AI agents

- [API documentation](http://ration.mayutic.com/docs/api): REST API and OAuth MCP connection guide.
- [MCP server card](http://ration.mayutic.com/.well-known/mcp/server-card.json): MCP server metadata (oauth2 transport).
- [OAuth authorization server](http://ration.mayutic.com/.well-known/oauth-authorization-server): OAuth 2.1 metadata for MCP clients.
- [Agent skills index](http://ration.mayutic.com/.well-known/agent-skills/index.json): Available agent skills exposed by Ration.
- [Auth discovery (auth.md)](http://ration.mayutic.com/auth.md): Agent-first onboarding flows (anonymous + user-claimed).
- [Connect agents](http://ration.mayutic.com/connect): One-click MCP setup for Cursor, Claude, and ChatGPT.
- [MCP listing (mcp.md)](http://ration.mayutic.com/mcp.md): Product overview and directory listing for mcpservers.org and similar indexes.

## Blog

The Ration blog covers AI-native kitchen software, MCP integrations, and the workflows that emerge when an AI agent has structured access to your pantry.

- [Ration for iOS: One Kitchen, Every Surface](http://ration.mayutic.com/blog/ration-ios-one-kitchen-every-surface): Ration Kitchen Hub is on the App Store. Same household data model across iPhone, web, Ask Ration, and MCP — Cargo, Galley, Manifest, and Supply stay in sync wherever dinner happens.
- [Pantry App vs Recipe Manager vs Meal Planner](http://ration.mayutic.com/blog/pantry-app-vs-recipe-manager-vs-meal-planner): These three kitchen app categories solve different jobs. Here is how to tell them apart, when you need more than one, and why a connected loop beats stitching tools together.
- [Agentic App Control Is the Next Interface: How Ration Copilot Changes Pantry Management](http://ration.mayutic.com/blog/agentic-app-control-copilot): Why in-app AI copilots that take action, not just answer questions, are the next interface for pantry management, meal planning, and grocery logistics. Ration Copilot as a case study.
- [Building Ration Copilot on Cloudflare Think: Workers, AI Search, and Durable Objects](http://ration.mayutic.com/blog/building-ration-copilot-cloudflare-think): A technical walkthrough of Ration's first-party AI assistant: Project Think on Durable Objects, managed AI Search for docs, Vectorize for pantry semantics, and shared MCP tool runtime on Cloudflare Workers.
- [Let Your Agent Connect Itself: Agent-First MCP Onboarding for Ration](http://ration.mayutic.com/blog/agent-first-mcp-onboarding): How autonomous MCP clients self-register via auth.md, configure Ration in Claude, Cursor, ChatGPT, or Goose, and start managing a real kitchen — then you claim ownership whenever you want.
- [How Ration Uses Cloudflare Vectorize for Semantic Pantry Search](http://ration.mayutic.com/blog/cloudflare-vectorize-semantic-pantry-search): A technical walkthrough of Ration's semantic ingredient matching stack: embeddings, Vectorize namespaces, D1 hydration, and quantity-aware result validation.
- [Food Waste Is a Data Pipeline Problem](http://ration.mayutic.com/blog/food-waste-data-pipeline): Reducing household food waste is not only about discipline. It is mostly an information freshness problem across inventory, recipes, planning, and shopping.
- [Designing a Consumer App for AI Agents: Ration's MCP Architecture](http://ration.mayutic.com/blog/mcp-consumer-app-architecture): How Ration exposes pantry, meal planning, and shopping workflows through MCP with scoped auth, tool-level safety controls, and predictable schemas.
- [Why Pantry Search Needs Semantics, Not Just Keywords](http://ration.mayutic.com/blog/semantic-pantry-search): Keyword search breaks in real kitchens because pantry data is messy human language. Here is how semantic matching makes pantry inventory actually useful.
- [Breaking the Meal Planning Loop](http://ration.mayutic.com/blog/meal-planning-loop): The weekly cycle of planning, shopping, cooking, and repeating is relentless by nature. Here's how a connected workflow reduces the overhead without adding complexity.
- [The Pantry Data Problem](http://ration.mayutic.com/blog/pantry-data-problem): Most pantry trackers fail because getting data in is harder than keeping it organized. Here's how AI image processing, APIs, and structured ingestion change the equation.
- [Your Kitchen Has an API Now](http://ration.mayutic.com/blog/mcp-kitchen-assistant): How to connect Ration to Claude, Cursor, and any MCP client — with real prompts, real outputs, and workflows that make it worth setting up.

## Discovery

- [Sitemap](http://ration.mayutic.com/sitemap.xml): Full list of indexable URLs.
- [RSS feed](http://ration.mayutic.com/blog/rss.xml): Subscribe to new blog posts.
- [Full content for LLMs](http://ration.mayutic.com/llms-full.txt): All blog posts and product copy concatenated for grounding.

## Contact

Ration is built by Mayutic. Reach out via [mayutic.com](https://www.mayutic.com).
