agent-chef-mcp 1.0.0 → 1.0.6

package/README.md

@@ -73,7 +73,7 @@ Client config for stdio:
 Without a key the server still lists everything; tool calls return a message explaining where to get a key.
 `npm run sync` refreshes `catalog.json` from the live server; `npm test` runs a stdio smoke test.
 
-## Tools (34)
+## Tools (37)
 
 | Area | Tools |
 |---|---|
@@ -82,7 +82,7 @@ Without a key the server still lists everything; tool calls return a message exp
 | Preferences | `get_recipe_preferences`, `update_recipe_preferences` |
 | Household | `get_members`, `upsert_member`, `remove_member` |
 | Pantry | `get_ingredients`, `update_ingredients` |
-| Recipes | `search_recipes`, `get_recipe`, `update_recipe`, `import_recipe`, `get_favorite_recipes`, `favorite_recipe`, `get_past_recipes` |
+| Recipes | `search_recipes`, `get_recipe`, `update_recipe`, `import_recipe`, `import_recipes`, `create_recipe`, `set_recipe_image`, `get_favorite_recipes`, `favorite_recipe`, `get_past_recipes` |
 | Weekly cycle | `propose_recipes`, `add_candidates`, `message_group`, `add_vote`, `add_ballot_feedback`, `get_past_votes`, `get_current_week`, `set_this_weeks_recipes`, `reopen_voting`, `set_voting_deadline`, `rate_recipe` |
 | Shopping | `assemble_online_grocery_order`, `record_grocery_order` |
 

package/catalog.json

@@ -1,10 +1,10 @@
 {
-  "synced_at": "2026-09-07T16:49:39.666Z",
+  "synced_at": "2026-09-08T21:03:09.112Z",
   "server": {
     "name": "agent-chef",
     "version": "0.4.0"
   },
-  "instructions": "# How to run Agent Chef\n\nYou are the household's agent. Agent Chef is the state machine; you are the hands. You never need to remember where the week stands: the server tells you.\n\nRUN LOOP. When the user says \"run agent chef\", call run_agent_chef (it returns this manual, today's checklist, and whether a recurring schedule exists) and follow it. The first time, also schedule yourself to run \"Run Agent Chef.\" twice a day (09:00 and 18:00 in the household's timezone) and confirm it with record_schedule, so the whole week runs end to end without anyone asking. Then:\n1. Call next_actions.\n2. Execute the returned actions in order. Each one names the tool, why it's due, and the arguments or message text to use. Where an argument is in <angle brackets>, you fill it in (e.g. write the 10 recipes).\n3. Call next_actions again. Repeat until it returns no actions, then stop and report a one-line summary.\n\nWHAT THE PHASES MEAN\n- new_cycle: it's past the household's plan day. Ask for ratings on last week's dinners if any are missing (don't wait for answers), then propose 10 recipes and send the ballot.\n- voting: people vote on their personal links until voting_closes_at (household setting: weekday + time; set_voting_deadline moves it). You may be asked to send one reminder to non-voters shortly before the deadline, or to add 2-3 options answering ballot feedback. When everyone has voted or the deadline passes, lock in the winners, announce them, and build the cart.\n- shopping: assemble_online_grocery_order gives you the list minus the pantry plus the household's shopping_preferences (brands, organic, substitutions): follow them when picking products. Fill the cart in the store's website, show the total, and STOP for explicit approval before checkout. Then record_grocery_order.\n- cooking / idle: nothing to do until the next plan day.\n\nWRITING RECIPES (propose_recipes / add_candidates): read get_recipe_preferences first. Source recipes from real pages: import_recipe(url) saves a recipe from a trusted site with its photo, ingredients and steps, then pass its recipe_id; aim for most of the ballot to come from real sources. search_recipes finds anything already in the library. PHOTOS ARE YOUR JOB: every candidate should have a real image_url (the source page's photo, or one you found by searching). The server checks each URL is a live image and rejects dead ones; a card without a photo means you skipped this. Use get_favorite_recipes (include 1-2), get_past_recipes (avoid repeats from the last ~4 weeks), get_past_votes (lean into what wins), get_ingredients (use what's on hand). Each recipe: title, one appetizing sentence, servings, complete ingredients with quantities, steps, tags, and a real image_url (see PHOTOS).\n\nMESSAGING: message_group sends SMS/email to members and personalises {vote_link} per person. Pass the kind the action specifies so the server can track what was sent. If the household prefers, you may post the same text into their own group chat instead; still call message_group so it's logged (it dry-runs if no provider is configured).\n\nRULES: never invent a vote or a rating; never check out without explicit approval in this conversation; keep messages short and friendly; if a tool errors, fix the input and retry once, then report.",
+  "instructions": "# How to run Agent Chef\n\nYou are the household's agent. Agent Chef is the state machine; you are the hands. You never need to remember where the week stands: the server tells you.\n\nRUN LOOP. When the user says \"run agent chef\", call run_agent_chef (it returns this manual, today's checklist, and whether a recurring schedule exists) and follow it. The first time, also schedule yourself to run \"Run Agent Chef.\" twice a day (09:00 and 18:00 in the household's timezone) and confirm it with record_schedule, so the whole week runs end to end without anyone asking. Then:\n1. Call next_actions.\n2. Execute the returned actions in order. Each one names the tool, why it's due, and the arguments or message text to use. Where an argument is in <angle brackets>, you fill it in (e.g. write the 10 recipes).\n3. Call next_actions again. Repeat until it returns no actions, then stop and report a one-line summary.\n\nWHAT THE PHASES MEAN\n- new_cycle: it's past the household's plan day. Propose 10 recipes and send the ballot. Last week's unrated dinners are collected on the ballot page itself (a rating card sits above the new options), so don't send a separate rating request; the ballot text mentions it.\n- voting: people vote on their personal links until voting_closes_at (household setting: weekday + time; set_voting_deadline moves it). You may be asked to send one reminder to non-voters shortly before the deadline, or to add 2-3 options answering ballot feedback. When everyone has voted or the deadline passes, lock in the winners, announce them, and build the cart.\n- shopping: assemble_online_grocery_order gives you the list minus the pantry plus the household's shopping_preferences (brands, organic, substitutions): follow them when picking products. Fill the cart in the store's website, show the total, and STOP for explicit approval before checkout. Then record_grocery_order.\n- cooking / idle: nothing to do until the next plan day.\n\nWRITING RECIPES (propose_recipes / add_candidates): read get_recipe_preferences first. Source recipes from real pages: import_recipe(url) saves a recipe from a trusted site with its photo, ingredients and steps, then pass its recipe_id; aim for most of the ballot to come from real sources. search_recipes finds anything already in the library. PHOTOS ARE YOUR JOB: every candidate should have a real image_url (the source page's photo, or one you found by searching). The server checks each URL is a live image and rejects dead ones; a card without a photo means you skipped this. If no real photo exists, generate one with your image tool (a realistic photo of the plated dish, natural light, no text, no people) and attach it with set_recipe_image, which stores it permanently; image-tool URLs expire, so never pass them as image_url directly. After propose_recipes, check the returned candidates for a missing image_url and fix each with set_recipe_image. Use get_favorite_recipes (include 1-2), get_past_recipes (avoid repeats from the last ~4 weeks), get_past_votes (lean into what wins), get_ingredients (use what's on hand). Each recipe: title, one appetizing sentence, servings, complete ingredients with quantities, steps, tags, and a real image_url (see PHOTOS).\n\nMESSAGING: message_group sends push notifications (to members who tapped \"notify me\" on their vote page), SMS or email, and personalises {vote_link} per person; channel auto picks push first, then text, then email. Pass the kind the action specifies so the server can track what was sent. If the household prefers, you may post the same text into their own group chat instead; still call message_group so it's logged (it dry-runs if no provider is configured).\n\nSWITCHING FROM ANOTHER APP: when the owner lists meals they loved elsewhere (Mealime, a meal kit, a recipe manager), find a real recipe page for each name on a well-known recipe site, then save them all at once with import_recipes (favorite_all: true); URLs they give you go straight in. If you have a browser tool, you can collect the favorites yourself: open the old app, let the owner sign in (never type their password), gather the recipe links, then import. Mealime and HelloFresh recipe pages import cleanly; Blue Apron and Marley Spoon block automated fetching, so for those read each recipe card in your browser and save it with create_recipe (title, ingredients with quantities, steps, servings, photo URL, source link, favorite: true). Use create_recipe whenever import_recipe fails on a page you can read. Report what you saved and what you could not find. Favorites are re-proposed on future ballots.\n\nHOUSEHOLDS OF ONE work the same way: one voter, top N by their votes, same loop. Never block on adding members.\n\nRULES: never invent a vote or a rating; never check out without explicit approval in this conversation; keep messages short and friendly; if a tool errors, fix the input and retry once, then report.",
   "tools": [
     {
       "name": "run_agent_chef",
@@ -964,7 +964,7 @@
     {
       "name": "get_members",
       "title": "Get household members",
-      "description": "List household members with contact info and their personal vote links.",
+      "description": "List household members with contact info, whether they get push notifications, and their personal vote links.",
       "inputSchema": {
         "type": "object",
         "properties": {}
@@ -1023,6 +1023,13 @@
                     "null"
                   ],
                   "description": "Personal voting page for this member"
+                },
+                "push_subscribed": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Has a device opted in to push notifications"
                 }
               },
               "required": [
@@ -1113,6 +1120,13 @@
               "null"
             ],
             "description": "Personal voting page for this member"
+          },
+          "push_subscribed": {
+            "type": [
+              "boolean",
+              "null"
+            ],
+            "description": "Has a device opted in to push notifications"
           }
         },
         "required": [
@@ -1194,6 +1208,13 @@
                     "null"
                   ],
                   "description": "Personal voting page for this member"
+                },
+                "push_subscribed": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ],
+                  "description": "Has a device opted in to push notifications"
                 }
               },
               "required": [
@@ -2502,6 +2523,368 @@
         "$schema": "http://json-schema.org/draft-07/schema#"
       }
     },
+    {
+      "name": "create_recipe",
+      "title": "Save a recipe you already have",
+      "description": "Save a recipe to the library from details you already have: one you read in your browser (when a site blocks import_recipe or has no recipe markup), one the owner dictated, or one you wrote. Provide the complete ingredient list with quantities and the steps; include the source page and a real photo URL when you have them. Optionally mark it a favorite.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string",
+            "minLength": 2
+          },
+          "description": {
+            "type": "string"
+          },
+          "image_url": {
+            "type": "string",
+            "description": "A real, publicly reachable photo of the dish; verified by the server and dropped if dead"
+          },
+          "source_url": {
+            "type": "string"
+          },
+          "servings": {
+            "type": "integer"
+          },
+          "ingredients": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Plain ingredient name, e.g. 'chicken thighs'"
+                },
+                "quantity": {
+                  "type": "string",
+                  "description": "Free text, e.g. '2 lbs', '1 bunch'"
+                }
+              },
+              "required": [
+                "name"
+              ],
+              "additionalProperties": false
+            },
+            "minItems": 1
+          },
+          "steps": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "favorite": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "title",
+          "ingredients",
+          "steps"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "openWorldHint": false
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "title": {
+            "$ref": "#/properties/id"
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "image_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_url": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "servings": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ingredients": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "$ref": "#/properties/id"
+                    },
+                    "quantity": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "description": "Free text, e.g. '2 lbs'"
+                    }
+                  },
+                  "required": [
+                    "name"
+                  ],
+                  "additionalProperties": true
+                }
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "steps": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "$ref": "#/properties/id"
+                }
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tags": {
+            "anyOf": [
+              {
+                "type": "array",
+                "items": {
+                  "$ref": "#/properties/id"
+                }
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "is_favorite": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "created_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "url": {
+            "$ref": "#/properties/id"
+          }
+        },
+        "required": [
+          "id",
+          "title",
+          "url"
+        ],
+        "additionalProperties": true,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
+    {
+      "name": "set_recipe_image",
+      "title": "Attach a photo to a recipe",
+      "description": "Store a photo for a recipe permanently and set it as the recipe's image. Use for images you generated with your image tool (their URLs expire) or any photo you have as a URL or base64. Pass either image_url (we fetch and copy it) or image_base64 + content_type. Max 6 MB; JPEG, PNG, WebP or GIF.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "recipe_id": {
+            "type": "string"
+          },
+          "image_url": {
+            "type": "string",
+            "format": "uri"
+          },
+          "image_base64": {
+            "type": "string",
+            "description": "Raw base64 (no data: prefix)"
+          },
+          "content_type": {
+            "type": "string",
+            "description": "e.g. image/png"
+          }
+        },
+        "required": [
+          "recipe_id"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "openWorldHint": false
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "recipe_id": {
+            "type": "string"
+          },
+          "image_url": {
+            "type": "string",
+            "description": "Permanent public URL of the stored photo"
+          }
+        },
+        "required": [
+          "recipe_id",
+          "image_url"
+        ],
+        "additionalProperties": true,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
+    {
+      "name": "import_recipes",
+      "title": "Import several recipes from URLs",
+      "description": "Bulk version of import_recipe: fetch up to 15 recipe pages and save them to the library, optionally marking each as a favorite. Use when the owner is moving favorites from another app (Mealime, a meal kit, a recipe manager). Names without URLs are your job: search for a real recipe page first, then pass the URLs here. Per-URL failures are reported, not thrown.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri"
+                },
+                "favorite": {
+                  "type": "boolean"
+                },
+                "tags": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "url"
+              ],
+              "additionalProperties": false
+            },
+            "minItems": 1,
+            "maxItems": 15
+          },
+          "favorite_all": {
+            "type": "boolean",
+            "description": "Mark every imported recipe as a favorite"
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "annotations": {
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "openWorldHint": true
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "imported": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "recipe_id": {
+                  "type": "string"
+                },
+                "title": {
+                  "$ref": "#/properties/imported/items/properties/recipe_id"
+                },
+                "url": {
+                  "$ref": "#/properties/imported/items/properties/recipe_id"
+                },
+                "favorite": {
+                  "type": "boolean"
+                },
+                "ingredients": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "recipe_id",
+                "title",
+                "url",
+                "favorite",
+                "ingredients"
+              ],
+              "additionalProperties": true
+            }
+          },
+          "failed": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "$ref": "#/properties/imported/items/properties/recipe_id"
+                },
+                "error": {
+                  "$ref": "#/properties/imported/items/properties/recipe_id"
+                }
+              },
+              "required": [
+                "url",
+                "error"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        "required": [
+          "imported",
+          "failed"
+        ],
+        "additionalProperties": true,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      }
+    },
     {
       "name": "get_past_recipes",
       "title": "Get past recipes",
@@ -3159,7 +3542,7 @@
                 },
                 "image_url": {
                   "type": "string",
-                  "description": "A real, publicly reachable photo of the dish: the og:image of the recipe page you used, or one found via web/image search. The server verifies the URL is an image and drops it otherwise. Never invent URLs; prefer import_recipe, which captures the source photo."
+                  "description": "A real, publicly reachable photo of the dish: the og:image of the recipe page you used, or one found via web/image search. The server verifies the URL is an image and drops it otherwise. Never invent URLs; prefer import_recipe, which captures the source photo. For generated images use set_recipe_image afterwards."
                 },
                 "source_url": {
                   "type": "string"
@@ -3503,7 +3886,7 @@
                 },
                 "image_url": {
                   "type": "string",
-                  "description": "A real, publicly reachable photo of the dish: the og:image of the recipe page you used, or one found via web/image search. The server verifies the URL is an image and drops it otherwise. Never invent URLs; prefer import_recipe, which captures the source photo."
+                  "description": "A real, publicly reachable photo of the dish: the og:image of the recipe page you used, or one found via web/image search. The server verifies the URL is an image and drops it otherwise. Never invent URLs; prefer import_recipe, which captures the source photo. For generated images use set_recipe_image afterwards."
                 },
                 "source_url": {
                   "type": "string"
@@ -3960,7 +4343,7 @@
     {
       "name": "message_group",
       "title": "Message the household",
-      "description": "Send SMS/MMS or email to household members. '{vote_link}' in the message becomes each member's personal voting link. Channel 'auto' texts members with a phone and emails the rest. Providers now: {\"sms\":\"dry-run\",\"email\":\"dry-run\"} (dry-run = logged only).",
+      "description": "Send a push notification, SMS/MMS or email to household members. '{vote_link}' in the message becomes each member's personal voting link. Channel 'auto' texts members with a phone and emails the rest. Providers now: {\"sms\":\"dry-run\",\"email\":\"dry-run\",\"push\":\"web-push\"} (dry-run = logged only).",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -3972,9 +4355,11 @@
             "enum": [
               "sms",
               "email",
+              "push",
               "auto"
             ],
-            "default": "auto"
+            "default": "auto",
+            "description": "auto = push to members who opted in on their vote page, else text if they have a phone, else email"
           },
           "subject": {
             "type": "string"
@@ -4031,6 +4416,12 @@
               },
               "email": {
                 "$ref": "#/properties/providers/properties/sms"
+              },
+              "push": {
+                "type": [
+                  "string",
+                  "null"
+                ]
               }
             },
             "required": [
@@ -4052,6 +4443,7 @@
                   "enum": [
                     "sms",
                     "email",
+                    "push",
                     "none"
                   ]
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-chef-mcp",
-  "version": "1.0.0",
+  "version": "1.0.6",
   "description": "Family meal planning run by your own AI agent: weekly dinners, household votes, grocery list minus the pantry. Stdio MCP server for the hosted Agent Chef service (https://agentchef.net/mcp).",
   "homepage": "https://agentchef.net",
   "repository": {