@mseep/wanderlog-mcp 0.3.1

package/dist/server.js

@@ -0,0 +1,164 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { addChecklist, addChecklistDescription, addChecklistInputSchema, } from "./tools/add-checklist.js";
+import { addExpense, addExpenseDescription, addExpenseInputSchema, } from "./tools/add-expense.js";
+import { annotatePlace, annotatePlaceDescription, annotatePlaceInputSchema, } from "./tools/annotate-place.js";
+import { addHotel, addHotelDescription, addHotelInputSchema, } from "./tools/add-hotel.js";
+import { addNote, addNoteDescription, addNoteInputSchema, } from "./tools/add-note.js";
+import { addPlace, addPlaceDescription, addPlaceInputSchema, } from "./tools/add-place.js";
+import { createTrip, createTripDescription, createTripInputSchema, } from "./tools/create-trip.js";
+import { getTrip, getTripDescription, getTripInputSchema, } from "./tools/get-trip.js";
+import { getTripUrl, getTripUrlDescription, getTripUrlInputSchema, } from "./tools/get-trip-url.js";
+import { listTrips, listTripsDescription, listTripsInputSchema, } from "./tools/list-trips.js";
+import { removePlace, removePlaceDescription, removePlaceInputSchema, } from "./tools/remove-place.js";
+import { searchPlaces, searchPlacesDescription, searchPlacesInputSchema, } from "./tools/search-places.js";
+import { updateTripDates, updateTripDatesDescription, updateTripDatesInputSchema, } from "./tools/update-trip-dates.js";
+import { renameDay, renameDayDescription, renameDayInputSchema, } from "./tools/rename-day.js";
+import { editNote, editNoteDescription, editNoteInputSchema, } from "./tools/edit-note.js";
+import { removeNote, removeNoteDescription, removeNoteInputSchema, } from "./tools/remove-note.js";
+import { searchGuides, searchGuidesDescription, searchGuidesInputSchema, } from "./tools/search-guides.js";
+import { getGuide, getGuideDescription, getGuideInputSchema, } from "./tools/get-guide.js";
+const AUTH_ERROR_RESPONSE = {
+    content: [
+        {
+            type: "text",
+            text: "Authentication required. Update WANDERLOG_COOKIE with a valid connect.sid cookie from wanderlog.com and restart the server.",
+        },
+    ],
+    isError: true,
+};
+function requireAuth(ctx, handler) {
+    return async (args) => {
+        if (!ctx.authenticated)
+            return AUTH_ERROR_RESPONSE;
+        return handler(args);
+    };
+}
+const SERVER_INSTRUCTIONS = `
+You are connected to Wanderdog, an MCP server for building Wanderlog trip itineraries.
+
+When a user asks you to create an itinerary or plan a trip, build it in full — not just a list
+of places. A complete itinerary uses these building blocks:
+
+  1. wanderlog_add_place — 3-5 places per day (attractions, restaurants, activities).
+     ALWAYS use the "note" parameter to attach practical context directly to the place: how to
+     get there, what to order, booking tips, opening hours. ALWAYS use "start_time" and
+     "end_time" to schedule each place (e.g. start_time: "09:00", end_time: "10:30").
+     This is one tool call instead of two — faster and the note lives on the place itself.
+  2. wanderlog_add_note — use ONLY for freestanding commentary between places: neighborhood
+     context, multi-stop transit directions, or day-level tips not about a specific place.
+     Do NOT use add_note for per-place context — use the "note" param on add_place instead.
+  3. wanderlog_add_hotel — one hotel block covering the full stay
+  4. wanderlog_add_checklist — at least one pre-trip checklist (visa, currency, offline maps,
+     return ticket, travel insurance) and per-day checklists for days that need advance prep
+  5. wanderlog_add_expense — add estimated costs for meals, entrance fees, transport passes.
+     Link each expense to its place for budget tracking.
+  6. wanderlog_annotate_place — update an existing place with a note, start/end time, or both.
+  7. wanderlog_search_guides + wanderlog_get_guide — when the user wants inspiration ("give
+     me an itinerary I can copy", "what guides exist for Vietnam"), call search_guides FIRST
+     to list curated user-written guides for the destination, then get_guide with the chosen
+     guide_key to read the full content. Use this for OTHER people's published guides; for
+     your own trips use wanderlog_get_trip.
+
+Example add_place call with all features:
+  wanderlog_add_place(trip_key, place: "Sensō-ji", day: "day 1",
+    note: "Arrive before 9am to avoid crowds. Free entry. The Nakamise shopping street
+    leading to the temple is great for souvenirs and snacks.",
+    start_time: "08:30", end_time: "10:00")
+
+Places without notes and times are just pins on a map. Rich places make an itinerary useful.
+`.trim();
+export function buildServer(ctx) {
+    const server = new McpServer({ name: "wanderlog-mcp", version: "0.2.0" }, { instructions: SERVER_INSTRUCTIONS });
+    server.registerTool("wanderlog_list_trips", {
+        title: "List Wanderlog trips",
+        description: listTripsDescription,
+        inputSchema: listTripsInputSchema,
+    }, requireAuth(ctx, async (args) => listTrips(ctx, args)));
+    server.registerTool("wanderlog_get_trip", {
+        title: "Get a Wanderlog trip",
+        description: getTripDescription,
+        inputSchema: getTripInputSchema,
+    }, requireAuth(ctx, async (args) => getTrip(ctx, args)));
+    server.registerTool("wanderlog_get_trip_url", {
+        title: "Get the wanderlog.com URL for a trip",
+        description: getTripUrlDescription,
+        inputSchema: getTripUrlInputSchema,
+    }, requireAuth(ctx, async (args) => getTripUrl(ctx, args)));
+    server.registerTool("wanderlog_search_places", {
+        title: "Search places near a Wanderlog trip",
+        description: searchPlacesDescription,
+        inputSchema: searchPlacesInputSchema,
+    }, requireAuth(ctx, async (args) => searchPlaces(ctx, args)));
+    server.registerTool("wanderlog_search_guides", {
+        title: "Search Wanderlog travel guides",
+        description: searchGuidesDescription,
+        inputSchema: searchGuidesInputSchema,
+    }, requireAuth(ctx, async (args) => searchGuides(ctx, args)));
+    server.registerTool("wanderlog_get_guide", {
+        title: "Read a Wanderlog travel guide",
+        description: getGuideDescription,
+        inputSchema: getGuideInputSchema,
+    }, requireAuth(ctx, async (args) => getGuide(ctx, args)));
+    server.registerTool("wanderlog_create_trip", {
+        title: "Create a Wanderlog trip",
+        description: createTripDescription,
+        inputSchema: createTripInputSchema,
+    }, requireAuth(ctx, async (args) => createTrip(ctx, args)));
+    server.registerTool("wanderlog_add_place", {
+        title: "Add a place to a Wanderlog trip",
+        description: addPlaceDescription,
+        inputSchema: addPlaceInputSchema,
+    }, requireAuth(ctx, async (args) => addPlace(ctx, args)));
+    server.registerTool("wanderlog_add_hotel", {
+        title: "Add a hotel booking to a Wanderlog trip",
+        description: addHotelDescription,
+        inputSchema: addHotelInputSchema,
+    }, requireAuth(ctx, async (args) => addHotel(ctx, args)));
+    server.registerTool("wanderlog_add_note", {
+        title: "Add a note to a Wanderlog trip",
+        description: addNoteDescription,
+        inputSchema: addNoteInputSchema,
+    }, requireAuth(ctx, async (args) => addNote(ctx, args)));
+    server.registerTool("wanderlog_add_checklist", {
+        title: "Add a checklist to a Wanderlog trip",
+        description: addChecklistDescription,
+        inputSchema: addChecklistInputSchema,
+    }, requireAuth(ctx, async (args) => addChecklist(ctx, args)));
+    server.registerTool("wanderlog_annotate_place", {
+        title: "Update a place with notes, times, or both",
+        description: annotatePlaceDescription,
+        inputSchema: annotatePlaceInputSchema,
+    }, requireAuth(ctx, async (args) => annotatePlace(ctx, args)));
+    server.registerTool("wanderlog_add_expense", {
+        title: "Add a budget expense to a Wanderlog trip",
+        description: addExpenseDescription,
+        inputSchema: addExpenseInputSchema,
+    }, requireAuth(ctx, async (args) => addExpense(ctx, args)));
+    server.registerTool("wanderlog_remove_place", {
+        title: "Remove a place from a Wanderlog trip",
+        description: removePlaceDescription,
+        inputSchema: removePlaceInputSchema,
+    }, requireAuth(ctx, async (args) => removePlace(ctx, args)));
+    server.registerTool("wanderlog_edit_note", {
+        title: "Edit note content in a Wanderlog trip",
+        description: editNoteDescription,
+        inputSchema: editNoteInputSchema,
+    }, requireAuth(ctx, async (args) => editNote(ctx, args)));
+    server.registerTool("wanderlog_remove_note", {
+        title: "Remove a note from a Wanderlog trip",
+        description: removeNoteDescription,
+        inputSchema: removeNoteInputSchema,
+    }, requireAuth(ctx, async (args) => removeNote(ctx, args)));
+    server.registerTool("wanderlog_update_trip_dates", {
+        title: "Update a Wanderlog trip's date range",
+        description: updateTripDatesDescription,
+        inputSchema: updateTripDatesInputSchema,
+    }, requireAuth(ctx, async (args) => updateTripDates(ctx, args)));
+    server.registerTool("wanderlog_rename_day", {
+        title: "Rename a day heading in a Wanderlog trip",
+        description: renameDayDescription,
+        inputSchema: renameDayInputSchema,
+    }, requireAuth(ctx, async (args) => renameDay(ctx, args)));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/add-checklist.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+import { buildChecklistBlock, findTargetSection, requireUserId, submitOp, } from "./shared.js";
+export const addChecklistInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip to add the checklist to. Use wanderlog_list_trips if you don't know the key."),
+    items: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe("Checklist items. Each string becomes one checkbox item, initially unchecked."),
+    title: z
+        .string()
+        .optional()
+        .describe("Optional title for the checklist (e.g. 'Packing list'). Omit for an untitled checklist."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional day to add the checklist to. Accepts 'day 2', 'May 4', or ISO '2026-05-04'. Omit to add to the 'Places to visit' list."),
+};
+export const addChecklistDescription = `
+Adds a checklist to a Wanderlog trip. Each item starts unchecked and can be ticked off in the
+Wanderlog app.
+
+Add at least one checklist per trip. Common patterns:
+- On the trip (no day): a packing list or "before departure" checklist
+- On day 1: an arrival-day checklist ("pick up Oyster card", "check into hotel", "buy SIM")
+- On specific days: day-of tasks ("bring swimsuit", "charge camera", "carry cash for market")
+
+Returns a confirmation including the checklist title and item count.
+`.trim();
+export async function addChecklist(ctx, args) {
+    try {
+        const userId = requireUserId(ctx);
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        const target = findTargetSection(trip, args.day);
+        const block = buildChecklistBlock(args.items, args.title ?? "", userId);
+        const insertIndex = target.section.blocks.length;
+        const ops = [
+            {
+                p: ["itinerary", "sections", target.index, "blocks", insertIndex],
+                li: block,
+            },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        const titlePart = args.title ? `"${args.title}" ` : "";
+        const text = `Added checklist ${titlePart}(${args.items.length} items) to ${target.label} in "${trip.title}".`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=add-checklist.js.map

package/dist/tools/add-checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-checklist.js","sourceRoot":"","sources":["../../src/tools/add-checklist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,uFAAuF,CAAC;IACpG,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yFAAyF,CAAC;IACtG,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iIAAiI,CAClI;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;CAUtC,CAAC,IAAI,EAAE,CAAC;AAST,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAe,EACf,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;QAE5B,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACjD,MAAM,GAAG,GAAc;YACrB;gBACE,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC;gBACjE,EAAE,EAAE,KAAK;aACV;SACF,CAAC;QAEF,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAExC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,mBAAmB,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,cAAc,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;QAC/G,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GACP,GAAG,YAAY,cAAc;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,EAAE;YACrB,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/tools/add-expense.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+import { resolvePlaceRef } from "../resolvers/place-ref.js";
+import { isPlaceBlock } from "../types.js";
+import { generateBlockId, requireUserId, submitOp } from "./shared.js";
+export const addExpenseInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip to add the expense to."),
+    amount: z
+        .number()
+        .positive()
+        .describe("Cost amount (e.g. 50, 12.50)."),
+    currency: z
+        .string()
+        .min(3)
+        .max(3)
+        .default("USD")
+        .describe("ISO 4217 currency code (e.g. 'USD', 'JPY', 'EUR'). Defaults to USD."),
+    category: z
+        .enum([
+        "food",
+        "drinks",
+        "groceries",
+        "publicTransit",
+        "carRental",
+        "gas",
+        "flights",
+        "lodging",
+        "sightseeing",
+        "activities",
+        "shopping",
+        "other",
+    ])
+        .default("other")
+        .describe("Expense category."),
+    description: z
+        .string()
+        .min(1)
+        .describe("What the expense is for (e.g. 'Lunch at Ichiran Ramen', 'Subway day pass')."),
+    place: z
+        .string()
+        .min(1)
+        .describe("Natural-language reference to link this expense to a place in the trip (e.g. 'Sensō-ji', 'the hotel'). Required — every expense must be linked to a place."),
+    date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+        .optional()
+        .describe("Date of the expense, YYYY-MM-DD. Defaults to today if omitted."),
+};
+export const addExpenseDescription = `
+Adds a budget expense to a Wanderlog trip linked to a specific place. Expenses appear in the
+trip's budget tracker on the linked place.
+
+Use this after adding places to give the trip a cost dimension — estimated meal costs, entrance
+fees, transport passes, etc. The place must already exist in the trip.
+
+Returns confirmation with the expense amount and description.
+`.trim();
+export async function addExpense(ctx, args) {
+    try {
+        const userId = requireUserId(ctx);
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        // Every expense must be linked to a place — Wanderlog's UI crashes on
+        // unlinked expenses (blockId: null triggers an undefined .text access).
+        const result = resolvePlaceRef(trip, args.place);
+        if (result.kind === "ambiguous") {
+            const lines = result.candidates.map((c, i) => {
+                const name = isPlaceBlock(c.block) ? c.block.place.name : `block #${c.block.id}`;
+                const loc = c.section.date ? `day ${c.section.date}` : c.section.heading || "unscheduled";
+                return `  ${i + 1}. ${name} (${loc})`;
+            });
+            const text = `Multiple places match "${args.place}":\n${lines.join("\n")}\n\nRetry with a more specific reference.`;
+            return { content: [{ type: "text", text }] };
+        }
+        if (result.kind === "none") {
+            throw new WanderlogError(`No place matching "${args.place}" found in "${trip.title}"`, "place_ref_not_found", {
+                hint: "Add the place to the trip first with wanderlog_add_place, then add the expense.",
+                followUps: [
+                    `Call wanderlog_get_trip with trip_key "${args.trip_key}" to see existing places.`,
+                ],
+            });
+        }
+        const blockId = result.match.block.id;
+        const associatedDate = result.match.section.date;
+        const expenseDate = args.date ?? new Date().toISOString().slice(0, 10);
+        // Build the expense object matching Wanderlog's schema
+        const expense = {
+            id: generateBlockId(),
+            amount: {
+                amount: args.amount,
+                currencyCode: args.currency.toUpperCase(),
+            },
+            category: args.category,
+            description: args.description,
+            date: expenseDate,
+            paidByUserId: userId,
+            paidByUser: { type: "registered", id: userId },
+            splitWith: { type: "individuals", users: [] },
+            blockId: blockId,
+            associatedDate: associatedDate ?? expenseDate,
+        };
+        // Find the current expenses array length to insert at the end
+        const budget = trip.itinerary.budget;
+        const expenses = budget?.expenses ?? [];
+        const insertIndex = expenses.length;
+        const ops = [
+            {
+                p: ["itinerary", "budget", "expenses", insertIndex],
+                li: expense,
+            },
+        ];
+        await submitOp(ctx, args.trip_key, ops);
+        const currencyLabel = args.currency.toUpperCase();
+        const text = `Added expense: ${currencyLabel} ${args.amount} for "${args.description}" (linked to ${args.place}) in "${trip.title}".`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=add-expense.js.map

package/dist/tools/add-expense.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-expense.js","sourceRoot":"","sources":["../../src/tools/add-expense.ts"],"names":[],"mappings":"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"}

package/dist/tools/add-hotel.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import { WanderlogError, WanderlogValidationError } from "../errors.js";
+import { buildPlaceBlock, findHotelsSection, findTripCenter, requireUserId, submitOp, } from "./shared.js";
+export const addHotelInputSchema = {
+    trip_key: z.string().min(1).describe("The trip to add the hotel to."),
+    hotel: z
+        .string()
+        .min(1)
+        .describe("Hotel name to search for. Examples: 'Park Hyatt Tokyo', 'the cheap hostel near the train station'. Matched against Google Places near the trip's destination."),
+    check_in: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+        .describe("Check-in date, YYYY-MM-DD."),
+    check_out: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, "must be YYYY-MM-DD")
+        .describe("Check-out date, YYYY-MM-DD. Must be after check_in."),
+};
+export const addHotelDescription = `
+Adds a hotel booking to a Wanderlog trip with check-in and check-out dates. If the trip does
+not yet have a "Hotels and lodging" section, one is created automatically.
+
+Returns confirmation with the resolved hotel name and the booking window.
+`.trim();
+export async function addHotel(ctx, args) {
+    try {
+        if (args.check_out <= args.check_in) {
+            throw new WanderlogValidationError(`check_out (${args.check_out}) must be after check_in (${args.check_in})`);
+        }
+        const userId = requireUserId(ctx);
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        const center = findTripCenter(trip, entry.geos);
+        if (!center) {
+            throw new WanderlogValidationError(`Cannot add hotel to "${trip.title}" because no location anchor is available`, "This trip has no associated geo and no existing places.");
+        }
+        const predictions = await ctx.rest.searchPlacesAutocomplete({
+            input: args.hotel,
+            sessionToken: crypto.randomUUID(),
+            location: { latitude: center.lat, longitude: center.lng },
+            radius: 15000,
+        });
+        if (predictions.length === 0) {
+            throw new WanderlogError(`No hotel found matching "${args.hotel}" near ${trip.title}`, "hotel_not_found", "Try a more specific name or check the spelling.");
+        }
+        const detail = await ctx.rest.getPlaceDetails(predictions[0].place_id);
+        const block = buildPlaceBlock(detail, userId, {
+            hotel: {
+                checkIn: args.check_in,
+                checkOut: args.check_out,
+                travelerNames: [],
+                confirmationNumber: null,
+            },
+        });
+        const existing = findHotelsSection(trip);
+        const ops = existing
+            ? [
+                {
+                    p: ["itinerary", "sections", existing.index, "blocks", existing.section.blocks.length],
+                    li: block,
+                },
+            ]
+            : [
+                {
+                    // Insert a new hotels section after the Notes section (index 1).
+                    // The existing sections shift down by 1.
+                    p: ["itinerary", "sections", 1],
+                    li: {
+                        id: Math.floor(Math.random() * 1_000_000_000),
+                        type: "hotels",
+                        mode: "placeList",
+                        heading: "Hotels and lodging",
+                        date: null,
+                        blocks: [block],
+                        placeMarkerColor: "#7045af",
+                        placeMarkerIcon: "bed",
+                        text: { ops: [{ insert: "\n" }] },
+                    },
+                },
+            ];
+        await submitOp(ctx, args.trip_key, ops);
+        const text = `Added ${detail.name} to "${trip.title}" · check-in ${args.check_in} → check-out ${args.check_out}.`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=add-hotel.js.map

package/dist/tools/add-hotel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-hotel.js","sourceRoot":"","sources":["../../src/tools/add-hotel.ts"],"names":[],"mappings":"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"}

package/dist/tools/add-note.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { WanderlogError } from "../errors.js";
+import { buildNoteBlock, findTargetSection, requireUserId, submitOp, } from "./shared.js";
+export const addNoteInputSchema = {
+    trip_key: z
+        .string()
+        .min(1)
+        .describe("The trip to add the note to. Use wanderlog_list_trips if you don't know the key."),
+    text: z
+        .string()
+        .min(1)
+        .describe("The note text. Plain text — can be multi-line."),
+    day: z
+        .string()
+        .optional()
+        .describe("Optional day to add the note to. Accepts 'day 2', 'May 4', or ISO '2026-05-04'. Omit to add to the 'Places to visit' list."),
+};
+export const addNoteDescription = `
+Adds a text note to a Wanderlog trip. Notes appear inline between places in a day, acting as
+the connective tissue of the itinerary. Every well-built day should have notes between stops.
+
+When to add a note (do this after adding each place or group of places):
+- How to get there: "Walk 15 min along the South Bank, or take the Jubilee line one stop"
+- Practical tips: "Book tickets online at least 2 days ahead — sells out in summer"
+- Food/drink recs: "Try the salt beef bagel at Beigel Bake — cash only, open 24hrs"
+- Time guidance: "Budget 2-3 hours here. Open 10am-6pm, closed Tuesdays"
+- Neighborhood context: "This area is great for wandering — no rush, just explore the lanes"
+
+Returns a confirmation of where the note was added.
+`.trim();
+export async function addNote(ctx, args) {
+    try {
+        const userId = requireUserId(ctx);
+        const entry = await ctx.tripCache.getEntry(args.trip_key);
+        const trip = entry.snapshot;
+        const target = findTargetSection(trip, args.day);
+        // Step 1: Insert the note block with placeholder text
+        const block = buildNoteBlock(userId);
+        const insertIndex = target.section.blocks.length;
+        const blockPath = ["itinerary", "sections", target.index, "blocks", insertIndex];
+        const insertOps = [{ p: blockPath, li: block }];
+        await submitOp(ctx, args.trip_key, insertOps);
+        // Step 2: Set the note text via rich-text subtype op
+        const textOps = [
+            {
+                p: [...blockPath, "text"],
+                t: "rich-text",
+                o: [{ insert: `${args.text}\n` }],
+            },
+        ];
+        await submitOp(ctx, args.trip_key, textOps);
+        const preview = args.text.length > 60 ? `${args.text.slice(0, 57)}…` : args.text;
+        const text = `Added note "${preview}" to ${target.label} in "${trip.title}".`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        const msg = err instanceof WanderlogError
+            ? err.toUserMessage()
+            : `Unexpected error: ${err.message}`;
+        return { content: [{ type: "text", text: msg }], isError: true };
+    }
+}
+//# sourceMappingURL=add-note.js.map

package/dist/tools/add-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-note.js","sourceRoot":"","sources":["../../src/tools/add-note.ts"],"names":[],"mappings":"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"}