mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy