Agent Documentation
Ration API and MCP Discovery
Ration exposes kitchen data to agents through a scoped REST API and a dedicated MCP server for conversational kitchen operations.
REST API
Send an organization-scoped API key with X-Api-Key or Authorization: Bearer <key>.
GET /api/v1/inventory/export— export Cargo as CSV.POST /api/v1/inventory/import— import Cargo from CSV.GET /api/v1/galley/export— export Galley as JSON.POST /api/v1/galley/import— import Galley from JSON.GET /api/v1/supply/export— export active Supply CSV.
MCP Server
Connect an MCP-compatible AI client to https://mcp.ration.mayutic.com/mcp. Ration is AI-agent-ready: paste the URL, complete browser sign-in, select your household, and approve granular permissions — no manual API key for standard clients.
Recommended: OAuth 2.1
- In your MCP client, add server URL `https://mcp.ration.mayutic.com/mcp`
- Complete browser sign-in, select your household, and approve permissions (in that order)
- Manage or revoke access anytime in Hub → Settings → Connected Agents
Supported clients
Cursor, Claude Desktop, ChatGPT desktop, Zed, Any MCP client with OAuth 2.1 discovery.
Advanced: API key auth
Organization API keys with mcp:* scopes remain supported for CI, custom headers, and legacy clients. Create keys in Hub → Settings → API Keys.
Discovery: MCP protected resource metadata, OAuth authorization server, MCP server card. Manage grants in Connected Agents.