@bojanrajkovic/mcp-paprika 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/tools/aisles.js

@@ -3,6 +3,8 @@ import { textResult } from "./helpers.js";
 export function registerAislesTool(server, ctx) {
     const log = ctx.log.child({ component: "list_aisles" });
     server.registerTool("list_aisles", {
+        title: "List grocery aisles",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all known aisles, sorted by order then name. " +
             "Includes the aisle UID needed for pantry and grocery item writes.",
         inputSchema: {},

package/dist/tools/categories.js

@@ -3,6 +3,8 @@ import { textResult } from "./helpers.js";
 export function registerCategoryTools(server, ctx) {
     const log = ctx.log.child({ component: "list_categories" });
     server.registerTool("list_categories", {
+        title: "List recipe categories",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all recipe categories with the number of recipes in each. Categories are sorted alphabetically.",
         inputSchema: {},
     }, async (_args) => {

package/dist/tools/category-writes.js

@@ -11,6 +11,8 @@ function categorySummary(ctx, category) {
 export function registerCreateCategoryTool(server, ctx) {
     const log = ctx.log.child({ component: "create_category" });
     server.registerTool("create_category", {
+        title: "Create a recipe category",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Create a new recipe category. Optionally nest it under an existing category by passing that " +
             "category's UID as `parentUid` to build a hierarchy (e.g. Thai → Curries). Use `list_categories` " +
             "to find parent UIDs. To put recipes in the new category, follow up with `update_recipe`.",
@@ -45,6 +47,8 @@ export function registerCreateCategoryTool(server, ctx) {
 export function registerUpdateCategoryTool(server, ctx) {
     const log = ctx.log.child({ component: "update_category" });
     server.registerTool("update_category", {
+        title: "Rename or re-parent a recipe category",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Rename and/or re-parent an existing category. Pass `name` to rename, `parentUid` to move it under " +
             "another category, or `null` for `parentUid` to make it top-level. Re-parenting builds the hierarchy " +
             "that `list_categories` renders.",
@@ -99,6 +103,8 @@ export function registerUpdateCategoryTool(server, ctx) {
 export function registerDeleteCategoryTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_category" });
     server.registerTool("delete_category", {
+        title: "Delete a recipe category",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Delete a category. Refuses if the category still has child categories or is assigned to any recipe — " +
             "reassign or delete those first (move recipes with `update_recipe`, re-parent children with " +
             "`update_category`). This keeps the hierarchy and recipe links consistent.",

package/dist/tools/create.js

@@ -6,6 +6,8 @@ import { coldStartGuard, commitRecipe, recipeToMarkdown, resolveCategoryRefs, te
 export function registerCreateTool(server, ctx) {
     const log = ctx.log.child({ component: "create_recipe" });
     server.registerTool("create_recipe", {
+        title: "Create a new recipe",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Create a new recipe in the Paprika account. If you built this recipe from a web page, " +
             "follow up with `upload_recipe_photo` and the page's main/hero (og:image) image URL to attach its photo.",
         inputSchema: {

package/dist/tools/delete.js

@@ -4,6 +4,8 @@ import { coldStartGuard, commitRecipe, textResult } from "./helpers.js";
 export function registerDeleteTool(server, ctx) {
     const log = ctx.log.child({ component: "trash_recipe" });
     server.registerTool("trash_recipe", {
+        title: "Move a recipe to the trash",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false },
         description: "Soft-delete a recipe by UID, moving it to the Paprika trash. " +
             "This operation is reversible — trashed recipes can be recovered in the Paprika app. " +
             "Requires an exact UID; fuzzy title matching is not supported to prevent accidental deletion.",

package/dist/tools/discover.js

@@ -3,6 +3,8 @@ import { coldStartGuard, recipeMetadataLines, textResult } from "./helpers.js";
 export function registerDiscoverTool(server, ctx, vectorStore) {
     const log = ctx.log.child({ component: "discover_recipes" });
     server.registerTool("discover_recipes", {
+        title: "Discover recipes by natural-language search",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Discover recipes using semantic search. Finds recipes matching a natural language description of what you're looking for.",
         inputSchema: {
             query: z.string().describe("Natural language description of what you're looking for"),

package/dist/tools/empty-trash.js

@@ -5,6 +5,8 @@ import { coldStartGuard, commitRecipeHardDelete, reconcileLocalRecipe, reconcile
 export function registerEmptyTrashTool(server, ctx) {
     const log = ctx.log.child({ component: "purge_recipe" });
     server.registerTool("purge_recipe", {
+        title: "Permanently delete a trashed recipe",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false },
         description: "Permanently delete a recipe that is already in the Paprika trash. " +
             "This is IRREVERSIBLE — once emptied from the trash the recipe cannot be recovered. " +
             "The recipe must first be moved to the trash with trash_recipe (a reversible soft-delete); " +

package/dist/tools/grocery-clear.js

@@ -5,6 +5,8 @@ import { textResult } from "./helpers.js";
 export function registerClearPurchasedTool(server, ctx) {
     const log = ctx.log.child({ component: "clear_purchased_grocery_items" });
     server.registerTool("clear_purchased_grocery_items", {
+        title: "Remove purchased items from a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Clear all purchased items from a grocery list.",
         inputSchema: {
             listUid: GroceryListUidSchema.describe("Grocery list UID to clear purchased items from"),
@@ -37,6 +39,8 @@ export function registerClearPurchasedTool(server, ctx) {
 export function registerClearAllTool(server, ctx) {
     const log = ctx.log.child({ component: "clear_grocery_list" });
     server.registerTool("clear_grocery_list", {
+        title: "Remove all items from a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Clear all items from a grocery list.",
         inputSchema: {
             listUid: GroceryListUidSchema.describe("Grocery list UID to clear all items from"),

package/dist/tools/grocery-item-purchase.js

@@ -11,6 +11,8 @@ export const markGroceryItemPurchasedInputSchema = z
 export function registerMarkGroceryItemPurchasedTool(server, ctx) {
     const log = ctx.log.child({ component: "mark_grocery_item_purchased" });
     server.registerTool("mark_grocery_item_purchased", {
+        title: "Mark a grocery item purchased",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Mark a grocery item as purchased (checked off) by UID.",
         inputSchema: markGroceryItemPurchasedInputSchema,
     }, async (args) => {

package/dist/tools/grocery-item.js

@@ -17,6 +17,8 @@ const itemInputSchema = z.object({
 export function registerAddGroceryItemsTool(server, ctx) {
     const log = ctx.log.child({ component: "add_grocery_items" });
     server.registerTool("add_grocery_items", {
+        title: "Add items to a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Add one or more items to a grocery list. Check read_grocery_list first to avoid duplicate ingredients — no server-side duplicate guard.",
         inputSchema: {
             listUid: GroceryListUidSchema.describe("UID of the grocery list to add items to"),
@@ -150,6 +152,8 @@ export const updateGroceryItemInputSchema = z
 export function registerUpdateGroceryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "update_grocery_item" });
     server.registerTool("update_grocery_item", {
+        title: "Edit a grocery item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update a grocery item's quantity, aisle, or notes by UID. Only provided fields are changed; " +
             "omitted fields retain their current values. To check an item off, use mark_grocery_item_purchased.",
         inputSchema: updateGroceryItemInputSchema,
@@ -188,6 +192,8 @@ export function registerUpdateGroceryItemTool(server, ctx) {
 export function registerDeleteGroceryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_grocery_item" });
     server.registerTool("delete_grocery_item", {
+        title: "Delete a grocery item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Delete a grocery item by UID.",
         inputSchema: {
             uid: GroceryItemUidSchema.describe("Grocery item UID to delete"),

package/dist/tools/grocery-list.js

@@ -6,6 +6,8 @@ import { formatLookupOutcome, resolveLookup, textResult, uidOrTextLookupSchema }
 export function registerListGroceryListsTool(server, ctx) {
     const log = ctx.log.child({ component: "list_grocery_lists" });
     server.registerTool("list_grocery_lists", {
+        title: "List your grocery lists",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all grocery lists sorted alphabetically by name, with UID and item count per list.",
         inputSchema: {},
     }, async () => {
@@ -28,6 +30,8 @@ export function registerListGroceryListsTool(server, ctx) {
 export function registerReadGroceryListTool(server, ctx) {
     const log = ctx.log.child({ component: "read_grocery_list" });
     server.registerTool("read_grocery_list", {
+        title: "Read a grocery list and its items",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Get a grocery list by UID or name. Name lookup is tiered (exact → starts-with → contains) " +
             "and case-insensitive, with a disambiguation list when multiple lists match the same tier. " +
             'Pass exactly one shape: {"uid": "..."} or {"name": "..."}.',
@@ -58,6 +62,8 @@ export function registerReadGroceryListTool(server, ctx) {
 export function registerCreateGroceryListTool(server, ctx) {
     const log = ctx.log.child({ component: "create_grocery_list" });
     server.registerTool("create_grocery_list", {
+        title: "Create a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Create a new grocery list with the given name. Rejects duplicate names (case-insensitive exact match); " +
             "if a duplicate is found, the response includes the existing UID.",
         inputSchema: {
@@ -99,6 +105,8 @@ export function registerCreateGroceryListTool(server, ctx) {
 export function registerRenameGroceryListTool(server, ctx) {
     const log = ctx.log.child({ component: "rename_grocery_list" });
     server.registerTool("rename_grocery_list", {
+        title: "Rename a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Rename a grocery list. Rejects if the new name conflicts with a different existing list.",
         inputSchema: {
             uid: GroceryListUidSchema.describe("Grocery list UID to rename"),
@@ -140,6 +148,8 @@ export function registerRenameGroceryListTool(server, ctx) {
 export function registerDeleteGroceryListTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_grocery_list" });
     server.registerTool("delete_grocery_list", {
+        title: "Delete a grocery list",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Delete a grocery list by UID.",
         inputSchema: {
             uid: GroceryListUidSchema.describe("Grocery list UID to delete"),

package/dist/tools/grocery-move.js

@@ -8,6 +8,8 @@ import { commitPantryItemsBatch } from "./pantry-helpers.js";
 export function registerMoveToPantryTool(server, ctx) {
     const log = ctx.log.child({ component: "move_grocery_items_to_pantry" });
     server.registerTool("move_grocery_items_to_pantry", {
+        title: "Move grocery items to the pantry",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false },
         description: "Move one or more grocery items to the pantry. Creates pantry items (with today's purchase date), then deletes the grocery items.",
         inputSchema: {
             uids: z.array(GroceryItemUidSchema).min(1).describe("Grocery item UIDs to move to pantry"),

package/dist/tools/list.js

@@ -3,6 +3,8 @@ import { coldStartGuard, textResult } from "./helpers.js";
 export function registerListTool(server, ctx) {
     const log = ctx.log.child({ component: "list_recipes" });
     server.registerTool("list_recipes", {
+        title: "List your saved recipes",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all recipes with pagination. Returns recipe summaries sorted alphabetically. Use offset/limit to paginate through the full library. Response includes total recipe count.",
         inputSchema: {
             offset: z.number().int().nonnegative().optional().default(0).describe("Number of recipes to skip (default: 0)"),

package/dist/tools/meal-add-menu.js

@@ -56,6 +56,8 @@ function renderPlannerAdds(menuName, startDay, items) {
 export function registerAddMenuToPlannerTool(server, ctx) {
     const log = ctx.log.child({ component: "schedule_menu" });
     server.registerTool("schedule_menu", {
+        title: "Add a saved menu's recipes to the meal planner",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Instantiate a saved menu's recipes as meal-planner entries. Look the menu up by UID or name " +
             "(tiered fuzzy match), then materialize each of its items into a meal dated start_date + (day − 1) " +
             "days, posting them all in one batch. This is a one-way COPY, not a link: the planner meals carry no " +

package/dist/tools/meal-history-search.js

@@ -30,6 +30,8 @@ export const searchMealHistoryInputSchema = z
 export function registerSearchMealHistoryTool(server, ctx) {
     const log = ctx.log.child({ component: "search_meal_history" });
     server.registerTool("search_meal_history", {
+        title: "Search past cooked meals by recipe or category",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: 'Search PAST meals (recall/browse), by a specific recipe, a recipe category ("class"), a meal type, ' +
             'and/or a date window — any combination, ANDed. Answers "when did we last have tacos", "how often do ' +
             'we eat Italian", "show the dinners we had in March", or "what have we eaten lately". With no filters ' +

package/dist/tools/meal-log-cooked.js

@@ -21,6 +21,8 @@ export const logCookedMealInputSchema = z
 export function registerLogCookedMealTool(server, ctx) {
     const log = ctx.log.child({ component: "log_cooked_meal" });
     server.registerTool("log_cooked_meal", {
+        title: "Log a meal you cooked",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Log a meal you cooked: records the given recipe on the planner, defaulting to today and the Dinner " +
             "meal type — a quick way to keep your cooking history current. Pass `date` to log a different day or " +
             "`type` for a non-dinner meal. To log a freeform (non-recipe) meal or to plan ahead in bulk, use plan_meals.",

package/dist/tools/meal-plan-read.js

@@ -16,6 +16,8 @@ export const readMealPlanInputSchema = z
 export function registerReadMealPlanTool(server, ctx) {
     const log = ctx.log.child({ component: "read_meal_plan" });
     server.registerTool("read_meal_plan", {
+        title: "Show upcoming planned meals",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Read the upcoming meal plan: meals scheduled from today forward, grouped by day in ascending date " +
             'order (today first). Defaults to the next 7 days; pass `days` to widen the window. For past meals or recall ("when did we last have X"), use search_meal_history.',
         inputSchema: readMealPlanInputSchema,

package/dist/tools/meal-reschedule.js

@@ -24,6 +24,8 @@ export const rescheduleMealInputSchema = z
 export function registerRescheduleMealTool(server, ctx) {
     const log = ctx.log.child({ component: "reschedule_meal" });
     server.registerTool("reschedule_meal", {
+        title: "Reschedule a planned meal",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Reschedule a planned meal to a different date by UID, optionally also changing its meal type. " +
             "Moving the date re-sequences the meal to the end of the destination day's order. To change a " +
             "meal's recipe link, freeform name, or scale instead, use update_meal.",

package/dist/tools/meal-types.js

@@ -35,6 +35,8 @@ function mealTypeLine(mt) {
 export function registerMealTypesTool(server, ctx) {
     const log = ctx.log.child({ component: "list_meal_types" });
     server.registerTool("list_meal_types", {
+        title: "List meal types",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all meal types — the built-in Breakfast/Lunch/Dinner/Snacks plus any custom " +
             "types — sorted by order then name. Each entry shows whether it is built-in or custom, " +
             "its calendar-export schedule (all-day or a clock time), and its UID. Reference a type " +

package/dist/tools/meal-writes.js

@@ -55,6 +55,8 @@ export const addMealsInputSchema = z.object({
 export function registerAddMealsTool(server, ctx) {
     const log = ctx.log.child({ component: "plan_meals" });
     server.registerTool("plan_meals", {
+        title: "Add meals to the planner",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Add one or more meals to the meal planner. Each item is EITHER recipe-linked (supply " +
             "recipe_uid; display name auto-resolves from the recipe) OR freeform (supply name; no " +
             "recipe). The two shapes are mutually exclusive — Paprika.app's UI dispatches display " +
@@ -226,6 +228,8 @@ export const updateMealInputSchema = z.object({
 export function registerUpdateMealTool(server, ctx) {
     const log = ctx.log.child({ component: "update_meal" });
     server.registerTool("update_meal", {
+        title: "Edit a planned meal",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update an existing meal by UID. The `update` payload is a discriminated union: pick exactly one " +
             "of {recipe_uid?, ...other} | {name, ...other} | {recipe_uid: null, name?, ...other}. Recipe link " +
             "and display name are structurally exclusive: name auto-resolves from the recipe for linked meals, " +
@@ -368,6 +372,8 @@ const deleteMealInputSchema = z.object({
 export function registerDeleteMealTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_meal" });
     server.registerTool("delete_meal", {
+        title: "Delete a planned meal",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Soft-delete a meal from the planner by UID. Idempotent: a second delete on the same UID " +
             "returns a friendly 'already deleted' message without re-POSTing. Requires an exact UID.",
         inputSchema: deleteMealInputSchema.shape,

package/dist/tools/menu-item-move.js

@@ -20,6 +20,8 @@ export const moveMenuItemInputSchema = z
 export function registerMoveMenuItemTool(server, ctx) {
     const log = ctx.log.child({ component: "move_menu_item" });
     server.registerTool("move_menu_item", {
+        title: "Move a menu item to a different day",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Move a menu item to a different day within its menu, by UID. A day beyond the menu's current span " +
             "auto-extends the menu so the item stays visible, and the item is re-sequenced to the end of the " +
             "menu's order. To change a menu item's meal type or recipe link instead, use update_menu_item.",

package/dist/tools/menu-item-write.js

@@ -47,6 +47,8 @@ export const addMenuItemsInputSchema = z.object({
 export function registerAddMenuItemsTool(server, ctx) {
     const log = ctx.log.child({ component: "add_menu_items" });
     server.registerTool("add_menu_items", {
+        title: "Add items to a menu",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Add one or more menuitems to a menu (saved meal plan). Look the menu up by UID or name (tiered " +
             "fuzzy match). Each item is EITHER recipe-linked (supply recipe_uid; display name auto-resolves " +
             "from the recipe) OR freeform (supply name; no recipe) — the two are mutually exclusive, matching " +
@@ -205,6 +207,8 @@ export const updateMenuItemInputSchema = z
 export function registerUpdateMenuItemTool(server, ctx) {
     const log = ctx.log.child({ component: "update_menu_item" });
     server.registerTool("update_menu_item", {
+        title: "Edit a menu item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update an existing menuitem's meal type or recipe link by UID. Provide at least one of type or " +
             "recipe_uid; omitted fields keep their current values. Changing recipe_uid re-resolves the display " +
             "name from the new recipe. To move an item to a different day, use move_menu_item. The menu link " +
@@ -283,6 +287,8 @@ export const deleteMenuItemInputSchema = z.object({
 export function registerDeleteMenuItemTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_menu_item" });
     server.registerTool("delete_menu_item", {
+        title: "Delete a menu item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Soft-delete a menuitem (a planned recipe) from a menu by UID. Idempotent: a second delete on the " +
             "same UID returns a friendly 'already deleted' message without re-POSTing. Requires an exact UID.",
         inputSchema: deleteMenuItemInputSchema.shape,

package/dist/tools/menu-read.js

@@ -4,6 +4,8 @@ import { menuStartGuard, menuToMarkdown } from "./menu-helpers.js";
 export function registerListMenusTool(server, ctx) {
     const log = ctx.log.child({ component: "list_menus" });
     server.registerTool("list_menus", {
+        title: "List your menus",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all menus (saved meal plans) in Paprika order, with item count and day span per menu. " +
             "Use read_menu to see a menu's full day-by-day breakdown.",
         inputSchema: {},
@@ -26,6 +28,8 @@ export function registerListMenusTool(server, ctx) {
 export function registerReadMenuTool(server, ctx) {
     const log = ctx.log.child({ component: "read_menu" });
     server.registerTool("read_menu", {
+        title: "Read a menu and its items",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Get a menu by UID or name, rendered day by day with each day's planned recipes. " +
             "Name lookup is tiered (exact → starts-with → contains) and case-insensitive, with a " +
             "disambiguation list when multiple menus match the same tier. Each recipe line carries " +

package/dist/tools/menu-write.js

@@ -6,6 +6,8 @@ import { commitMenu, commitMenuItemsBatch, menuStartGuard, menuToMarkdown } from
 export function registerCreateMenuTool(server, ctx) {
     const log = ctx.log.child({ component: "create_menu" });
     server.registerTool("create_menu", {
+        title: "Create a menu",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Create a new menu (saved meal plan) with the given name. Rejects duplicate names " +
             "(case-insensitive exact match); if a duplicate is found, the response includes the existing UID. " +
             "Optionally set the day span (default 1) and free-text notes.",
@@ -57,6 +59,8 @@ export function registerCreateMenuTool(server, ctx) {
 export function registerUpdateMenuTool(server, ctx) {
     const log = ctx.log.child({ component: "update_menu" });
     server.registerTool("update_menu", {
+        title: "Edit a menu",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update a menu's name, day span, and/or notes. Look it up by UID or name (tiered fuzzy match, " +
             "case-insensitive). Provide at least one of name, days, or notes. Renaming to a name already used " +
             "by a different menu is rejected (the existing UID is surfaced). Shrinking days below the highest " +
@@ -154,6 +158,8 @@ export function registerUpdateMenuTool(server, ctx) {
 export function registerDeleteMenuTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_menu" });
     server.registerTool("delete_menu", {
+        title: "Delete a menu",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false },
         description: "Delete a menu and all of its planned recipes (menuitems). Look it up by UID or name (tiered fuzzy " +
             "match, case-insensitive). The menuitems are tombstoned first, then the menu itself. " +
             'Pass exactly one lookup shape: {"uid": "..."} or {"name": "..."}.',

package/dist/tools/pantry-batch-add.js

@@ -20,6 +20,8 @@ const itemInputSchema = z.object({
 export function registerAddPantryItemsTool(server, ctx) {
     const log = ctx.log.child({ component: "add_pantry_items" });
     server.registerTool("add_pantry_items", {
+        title: "Add items to the pantry",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Add one or more items to the pantry. Skips items that duplicate an existing ingredient (case-insensitive) " +
             "and reports them with the existing UID and a suggestion to use update_pantry_item. " +
             "All date fields are validated up-front; a single unparseable date rejects the entire batch.",

package/dist/tools/pantry-delete.js

@@ -5,6 +5,8 @@ import { commitPantryItem, pantryStartGuard } from "./pantry-helpers.js";
 export function registerDeletePantryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_pantry_item" });
     server.registerTool("delete_pantry_item", {
+        title: "Delete a pantry item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Soft-delete a pantry item by UID. Idempotent: a second delete on the same UID " +
             "returns a friendly 'already deleted' message without re-saving. Requires an exact UID.",
         inputSchema: {

package/dist/tools/pantry-get.js

@@ -4,6 +4,8 @@ import { pantryItemToMarkdown, pantryStartGuard } from "./pantry-helpers.js";
 export function registerGetPantryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "read_pantry_item" });
     server.registerTool("read_pantry_item", {
+        title: "Read a pantry item",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Get a pantry item by UID or ingredient name. Ingredient lookup is fuzzy " +
             "(exact → starts-with → contains) and case-insensitive, with a disambiguation list " +
             "when multiple items match the same tier. " +

package/dist/tools/pantry-list.js

@@ -3,6 +3,8 @@ import { pantryStartGuard } from "./pantry-helpers.js";
 export function registerListPantryTool(server, ctx) {
     const log = ctx.log.child({ component: "list_pantry_items" });
     server.registerTool("list_pantry_items", {
+        title: "List your pantry items",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "List all pantry items sorted alphabetically by ingredient name. Returns the ingredient, quantity, and aisle for each item. Use read_pantry_item with the UID for full details.",
         inputSchema: {},
     }, async () => {

package/dist/tools/pantry-stock.js

@@ -16,6 +16,8 @@ export const restockPantryItemInputSchema = z
 export function registerMarkPantryItemOutOfStockTool(server, ctx) {
     const log = ctx.log.child({ component: "mark_pantry_item_out_of_stock" });
     server.registerTool("mark_pantry_item_out_of_stock", {
+        title: "Mark a pantry item out of stock",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Mark a pantry item as out of stock by UID (e.g. you've run out of it).",
         inputSchema: markPantryItemOutOfStockInputSchema,
     }, async (args) => {
@@ -43,6 +45,8 @@ export function registerMarkPantryItemOutOfStockTool(server, ctx) {
 export function registerRestockPantryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "restock_pantry_item" });
     server.registerTool("restock_pantry_item", {
+        title: "Mark a pantry item back in stock",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Mark a pantry item as back in stock by UID (e.g. you've restocked it).",
         inputSchema: restockPantryItemInputSchema,
     }, async (args) => {

package/dist/tools/pantry-update.js

@@ -28,6 +28,8 @@ export const updatePantryItemInputSchema = z
 export function registerUpdatePantryItemTool(server, ctx) {
     const log = ctx.log.child({ component: "update_pantry_item" });
     server.registerTool("update_pantry_item", {
+        title: "Edit a pantry item",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update a pantry item's ingredient, quantity, aisle, or dates by UID. Only provided fields are " +
             "changed; omitted fields retain their existing values. Setting expirationDate also updates " +
             "hasExpiration accordingly. To change stock status, use mark_pantry_item_out_of_stock / restock_pantry_item.",

package/dist/tools/photo-generate.js

@@ -41,6 +41,8 @@ export const generatePhotoInputSchema = z.object({
 export function registerGeneratePhotoTool(server, ctx, photographyClient) {
     const log = ctx.log.child({ component: "generate_recipe_photo" });
     server.registerTool("generate_recipe_photo", {
+        title: "Generate a recipe photo with AI",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Generate a styled food photo for a recipe with an AI image model and (by default) attach it to the " +
             "recipe. The prompt is built from the recipe's name, description, and categories — so well-described, " +
             "categorized recipes produce the best results; pass `style` to guide plating or describe an obscure dish. " +

package/dist/tools/photo-writes.js

@@ -99,6 +99,8 @@ async function resolveSourceBytes(source, ctx, recipeUid) {
 export function registerUploadPhotoTool(server, ctx) {
     const log = ctx.log.child({ component: "upload_recipe_photo" });
     server.registerTool("upload_recipe_photo", {
+        title: "Upload a photo to a recipe",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
         description: "Attach a photo to a recipe from exactly one `source`: a `url` (PREFERRED for web images — the server " +
             "downloads it), a `generation_token` (to save an image you previewed with generate_recipe_photo, attach:false — " +
             "no need to regenerate), or, for programmatic callers, inline `image_base64`. If you built the recipe " +
@@ -160,6 +162,8 @@ export function registerUploadPhotoTool(server, ctx) {
 export function registerDeletePhotoTool(server, ctx) {
     const log = ctx.log.child({ component: "delete_recipe_photo" });
     server.registerTool("delete_recipe_photo", {
+        title: "Delete a recipe photo",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Delete a photo from a recipe by UID. Idempotent: a second delete on the same UID returns a friendly " +
             "'already deleted' message without re-POSTing. Requires an exact photo UID.",
         inputSchema: deletePhotoInputSchema.shape,

package/dist/tools/read.js

@@ -3,6 +3,8 @@ import { coldStartGuard, formatLookupOutcome, recipeToMarkdown, resolveLookup, u
 export function registerReadTool(server, ctx) {
     const log = ctx.log.child({ component: "read_recipe" });
     server.registerTool("read_recipe", {
+        title: "Read a recipe by UID or title",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Read a recipe by UID or title. Title lookup is fuzzy (exact → starts-with → contains) " +
             "and returns a disambiguation list when multiple recipes match the same tier. " +
             'Pass exactly one shape: {"uid": "..."} or {"title": "..."}.',

package/dist/tools/recipe-categorize.js

@@ -24,6 +24,8 @@ export const categorizeRecipeInputSchema = z
 export function registerCategorizeRecipeTool(server, ctx) {
     const log = ctx.log.child({ component: "categorize_recipe" });
     server.registerTool("categorize_recipe", {
+        title: "Add, replace, or remove a recipe's categories",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Add, replace, or remove a recipe's categories by UID. Pass category names or UIDs and a mode: " +
             "add (union with current — the default), replace (set exactly these), or remove (drop these). " +
             "Unknown category names are skipped with a warning. To edit other recipe fields, use update_recipe.",

package/dist/tools/recipe-favorite.js

@@ -15,6 +15,8 @@ export const unfavoriteRecipeInputSchema = z
 export function registerFavoriteRecipeTool(server, ctx) {
     const log = ctx.log.child({ component: "favorite_recipe" });
     server.registerTool("favorite_recipe", {
+        title: "Mark a recipe as a favorite",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Mark a recipe as a favorite by UID (adds it to the Favorites list).",
         inputSchema: favoriteRecipeInputSchema,
     }, async (args) => {
@@ -43,6 +45,8 @@ export function registerFavoriteRecipeTool(server, ctx) {
 export function registerUnfavoriteRecipeTool(server, ctx) {
     const log = ctx.log.child({ component: "unfavorite_recipe" });
     server.registerTool("unfavorite_recipe", {
+        title: "Remove a recipe from favorites",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Remove a recipe from the Favorites list by UID.",
         inputSchema: unfavoriteRecipeInputSchema,
     }, async (args) => {

package/dist/tools/recipe-rating.js

@@ -11,6 +11,8 @@ export const rateRecipeInputSchema = z
 export function registerRateRecipeTool(server, ctx) {
     const log = ctx.log.child({ component: "rate_recipe" });
     server.registerTool("rate_recipe", {
+        title: "Rate a recipe",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Rate a recipe 0–5 stars by UID. Sets the recipe's star rating; pass 0 to clear it.",
         inputSchema: rateRecipeInputSchema,
     }, async (args) => {

package/dist/tools/recipe-restore.js

@@ -11,6 +11,8 @@ export const restoreRecipeInputSchema = z
 export function registerRestoreRecipeTool(server, ctx) {
     const log = ctx.log.child({ component: "restore_recipe" });
     server.registerTool("restore_recipe", {
+        title: "Restore a recipe from the trash",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
         description: "Restore a trashed recipe by UID, moving it out of the trash back into the active library. " +
             "The inverse of trash_recipe; use purge_recipe to permanently delete a trashed recipe instead.",
         inputSchema: restoreRecipeInputSchema,

package/dist/tools/search.js

@@ -31,6 +31,8 @@ export const searchRecipesInputSchema = z
 export function registerSearchTool(server, ctx) {
     const log = ctx.log.child({ component: "search_recipes" });
     server.registerTool("search_recipes", {
+        title: "Search recipes by name, ingredient, or time",
+        annotations: { readOnlyHint: true, idempotentHint: true },
         description: "Search and filter recipes. Use any combination of: free-text query (matches name, " +
             "ingredients, description), an ingredient list with all/any match mode, and/or max " +
             "prep/cook/total time constraints. At least one criterion is required. Results are " +

package/dist/tools/update.js

@@ -29,6 +29,8 @@ export const updateRecipeInputSchema = z
 export function registerUpdateTool(server, ctx) {
     const log = ctx.log.child({ component: "update_recipe" });
     server.registerTool("update_recipe", {
+        title: "Edit a recipe's details",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
         description: "Update a recipe's content fields by UID (name, ingredients, directions, description, notes, " +
             "servings, prep/cook/total time, source, difficulty, nutritional info). Only provided fields " +
             "change; omitted fields keep their values. This tool does NOT edit rating, categories, favorite " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bojanrajkovic/mcp-paprika",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.3",
   "description": "MCP server for Paprika recipe manager",
   "license": "MIT",
   "repository": {