Ration user guide

This guide explains how to use Ration. Ask Ration searches the same articles. Prefer the in-app screens when a detail differs from this text.

Browse topics below, or open Ask Ration from the hub for the same answers with live account context.

Overview

• What is Ration? — Product overview: kitchen loop, Ask Ration (Copilot), and MCP as kitchen memory for AI.
• Key concepts — Organizations, credits, and the four kitchen surfaces.
• Account and sign-in — Magic link, Google sign-in, and profile basics.
• Switching groups — Choose the active organization and keep data isolated.
• Groups and membership — Invite, roles, ownership transfer, credits, and delete group.
• Ask Ration vs reading the guide — Same source of truth for Copilot and self-serve reading.

Kitchen loop

• The kitchen loop — How Cargo, Galley, Manifest, and Supply work together.
• Cargo (pantry inventory) — Add, edit, restock, jettison, import, and promote items.
• Receipt scanning — Scan a receipt into Cargo with AI credits.
• Galley (recipes and provisions) — Create meals, cook from stock, and select for Supply.
• Import a recipe from a URL — Pull a recipe from an HTTPS page into Galley.
• AI meal generation — Generate recipe ideas from your pantry.
• Manifest (meal plan) — Schedule meals, consume entries, and share the week.
• Supply (shopping list) — Sync, shop, snooze, share, and dock purchases into Cargo.
• Matching cookable meals — Strict vs partial pantry match for meals ready to cook.
• Hub dashboard and settings — Widgets, preferences, developer tools, and account purge.

Billing and credits

• AI credits explained — What spends credits and what does not.
• Buying credits and Stripe — Checkout, packs, and the billing portal.
• Free vs Crew Member — Capacity limits, invites, and owner-tier rules.
• Welcome offer and promotions — automatic 12 welcome credits for new human accounts.

Agents and API

• MCP overview — Connect an AI agent to your kitchen with OAuth.
• Connecting to MCP — Client setup steps and common OAuth failures.
• MCP tools reference — Tool catalog and rate-limit categories.
• MCP vs web app — What agents can and cannot do compared to the hub.
• REST API (v1) overview — API keys, scopes, and import/export endpoints.

Security and privacy

• Security overview — Auth, isolation, rate limits, and Copilot posture.
• Data, privacy, and deletion — Where legal policies live and what purge removes.
• API key safety — OAuth vs keys, rotation, and storage hygiene.

Architecture and limits

• Architecture at a glance — D1, R2, KV, and Vectorize in plain language.
• Async jobs and reliability — Queues, refunds, and idempotent AI jobs.
• Limits and rate limits — Tier caps and web/MCP throttles.

Troubleshooting

• Common troubleshooting — Credits, wrong group, scan stuck, share blocked.
• Billing troubleshooting — Missing credits, portal access, and what to tell support.

Legal

Full Terms and Privacy live on the site: /legal/terms and /legal/privacy.