Returns the signed-in username and a summary of the whole library: how many lists, categories, and items exist, plus library-wide settings (units, currency symbol).

Forces a re-fetch of the entire library from the LighterPack server, discarding the local cache. Use this if you suspect the data changed elsewhere (e.g. the user editing lighterpack.com directly) mid-session.

Sets the unit LighterPack's own UI uses to display list totals (oz/lb/g/kg). This does not affect the units this MCP server reports back to you — tool responses always use grams.

Sets the unit LighterPack's own UI pre-fills when a person adds a new item there. Items you add through this MCP server always take an explicit weight_unit per call, so this only affects lighterpack.com's own editing UI.

Sets the currency symbol (1-4 characters, e.g. "$", "€", "R$") shown next to prices.

Creates a new, empty packing list.

Returns a summary (name, category count, total weight/price) of every packing list in the account.

Returns full detail for one packing list: every category, every item (with weight, price, qty, worn/consumable/star flags), and computed totals.

Toggles which optional columns show for a list: item images, prices, worn, consumable, list description, and total pack weight. Only the keys you pass are changed.

Duplicates a list and its categories. The copy references the SAME item rows as the original (shared items — editing one updates both); use fork_item afterwards to detach a specific item.

Deletes a list and all its categories. Fails if this is the only remaining list in the account. Items that are also referenced by other lists are left intact.

Mints a public, read-only share link for a list (https://lighterpack.com/r/). Anyone with the link can view the list without an account.

Sets a category's swatch color (hex, e.g. "#ff8800"). Omit color to clear it and let LighterPack auto-assign one.

Removes a category from a list. Fails if it's the list's last category unless force is true.

Sets the display order of a list's categories. categoryIds must contain exactly the list's existing category ids, just reordered.

Adds a new item to a category, or — if existingItemId is given — links an already-existing item into this category as a shared item (editing it later updates every category it appears in).

Patches any subset of an item's own fields — name, description, price, weight, link (url), or image URL. This is how you rename an item, change its price, or add a link. Only the fields you pass are changed. Note the item may be shared across multiple categories/lists; this updates it everywhere it appears.

Unlinks an item from a single category. The item row itself (and its placement in any other category) is untouched. Use delete_item to remove it everywhere.

Deletes an item from the library and unlinks it from every category/list that references it. This cannot be undone.

Detaches a shared item into an independent copy for one specific list, so future edits to the original no longer affect this list's copy.

Points an item at an externally-hosted image URL (no upload involved). Use upload_item_image instead to upload a local/binary image.

Uploads a local image file (JPEG/PNG/WebP, 5MB max) to LighterPack and sets it as the item's photo. Provide either filePath (read from disk) or imageBase64 (raw base64-encoded bytes) plus mimeType.

Decreases quantity, floored at 0 (never negative).

Worn and consumable are mutually exclusive: setting worn=true automatically clears consumable on this item placement.

Worn and consumable are mutually exclusive: setting consumable=true automatically clears worn on this item placement.

Sets the star level for this item placement: 0 = unstarred, 1 = favorite, up to 3 (LighterPack's star is a 3-level rating, not a plain on/off flag).

Adds several items to one category in a single save round-trip — much more efficient than calling add_item_to_category repeatedly.

Scaffolds a complete new list — categories and their items — in a single save round-trip.

Applies field edits (name/description/price/weight/url/imageUrl) and/or flag edits (qty/worn/consumable/star) across many items in a single save round-trip.