# MealOS

> Price-aware recipe, meal-planning and food-budgeting platform for a household. Agents welcome: every tool is
> one contract served over MCP and REST.

Money is integer minor units with a currency; converted amounts are approximate and cite their rate date.
Only read tools run directly; anything that changes data becomes a proposal a person approves.

## Tool endpoints

- [MCP (streamable HTTP, JSON responses)](https://upbeat-scorpion-921.convex.site/mcp): POST JSON-RPC; tools/list and tools/call
- [REST](https://upbeat-scorpion-921.convex.site/api/v1/tools/{name}): POST the tool input as JSON
- [OpenAPI 3.1](https://menubudget.com/openapi.json): every tool as one POST operation
- Auth: public tools need no key; others need `Authorization: Bearer <agent key>`, issued by the household owner

## Tools

- `ping` (read, public): Health check. Returns pong, echoing the optional message. Reads no household data; safe to call without a key.

## Pages

- https://menubudget.com/recipes/{slug}: a recipe
- https://menubudget.com/plans/{id}: a meal plan
- https://menubudget.com/lists/{id}: a shopping list
- https://menubudget.com/pantry: the household's pantry
- https://menubudget.com/reports/{cycle}: a budget report for a cycle
- https://menubudget.com/settings/agents: invite agents and manage their keys (household owner)