The Meal Plan Vault Agent API
API by The Meal Plan Vault · rest
REST access to The Meal Plan Vault for AI agents — recipes, weekly meal plans, grocery lists, and the pantry. Every operation is POST /tools/{tool_name} with the tool's arguments as a JSON body (send {} when there are none). Responses are the tool's JSON result. These are the same tools the MCP server at https://www.mealplanvault.com/mcp exposes. Authentication: send a personal access token as Authorization: Bearer mpv_pat_…. The owner creates one in The Meal Plan Vault under Settings → Connections → API access. Read-only tokens can call read operations; read-and-write tokens can call everything. Call GET /me to check a token. All data is scoped to the token owner's household and their household role. Every call is recorded in an activity log the owner can review.
Endpoint: https://www.mealplanvault.com/api/agent/v1
Verification: observed. Source: crawl.
Capabilities (46)
- Check the token and list the operations it can call
- Add an item to a list
- Fill your cart at a store from a list (never checks out)
- Add something you just bought
- Follow a recipe site by its address
- Check an item off while shopping
- Repeat a past week into another week
- Build a list from a week's plan sorted by aisle
- Write a new recipe into the vault
- Delete a list and its items
- Delete a recipe from the vault
- Find recipes that use what's on sale at your stores
- Find recipes you can make with what's in the fridge or that use up what…
- Check your plan trial days left and recipe and import allowances
- Read a day's meals with calories and protein to log in a calorie tracker
- Read a list aisle by aisle or just what's left
- Read a holiday dinner menu with its countdown day-of schedule and grocery list
- See what the household ate most often over any stretch of days
- Calories and macros for each planned meal per person
- Read any week of the plan
- Read a prep day: every batch scaled ingredients and steps longest first
- Read a recipe in full — ingredients steps tags
- Search and filter recipes from the sites you follow
- Hide a recipe from your followed-sites feed
- Import a recipe from any link