Skip to main content
When your AI assistant connects to plamotrack, it has access to over 30 tools organised by area. This page lists every tool and what it does — useful if you want to understand what your agent can and can’t do, or to write precise instructions for it.
Import and export have no MCP tools. An agent that can silently replace your entire collection is not a feature.

​
Collection overview

Returns the app version and the instance’s reference currency — the currency an order’s own currency_code defaults to when you omit it while logging an order.
Returns your collection at a glance: kits per status, and orders per stage (pre-ordered, ordered, in transit, received). These are the same numbers shown on the Home page.

​
Kits

Lists kits in your collection, with optional filters for status, grade, or series. Use sort=completed or sort=started to order by the build’s own dates, sort=recent for the kits that moved most recently, or sort=newest for the latest added; use limit to cap the number returned.
Returns every series name already in use in your collection. Check this before creating a new series to avoid ending up with “Iron-Blooded Orphans”, “IBO”, and “Iron Blooded Orphans” as three separate series.
Returns one kit in full — all fields, including status, grade, series, rating, notes, and build dates.
Adds a kit that wasn’t purchased through an order — a gift, a trade, or a carry-over from before you started tracking. For kits you bought, use create_order instead: that records the retailer, the spend, and the kit in one step.
Moves a kit along the pipeline — for example, from Backlog to Building, or from Building to Complete. Dates are recorded alongside each status change.
Edits a kit’s details: name, grade, series, rating, notes, and build start/finish dates.

​
Catalog & inventory

These tools cover tools, consumables, upgrade parts, and display gear.
Searches all four catalog tables at once — the same search the UI typeahead uses. Agents hitting this tool land on the same de-duplication as a human, so “Extra Thin Cement” doesn’t become two separate entries.
Returns all items from one catalog table, optionally filtered by category. Use this when you want a complete picture of a table rather than a keyword search.
Returns category names already in use on a specific catalog table. Check this before writing a new category name to avoid spelling variants.
Adds a catalog item without a purchase — a first stocktake, a gift, or something you already owned before you started tracking. There’s one tool per catalog type, each accepting the fields specific to that table.
Edits a catalog item’s details. Each tool handles one catalog type and accepts only that table’s own fields.
Nudges a quantity up or down, with a reason. Use this for corrections, stocktakes, or manual adjustments — not for purchases, which go through create_order.
Records an upgrade part going onto a specific kit. Decrements the part’s stock and creates a record of what went where.
Undoes an upgrade application. You choose whether the part goes back into stock or not.

​
Retailers

Returns every shop on record, including each retailer’s report card: rating, packing quality, shipping speed, and the would-you-order-again field.
Adds a shop or updates an existing one — name, URL, notes, and the full report card.

​
Orders

Creates a full order with line items. Kit lines fan out into individual kit rows (two Zakus on one line becomes two separate kits in your collection). Name the shop with retailer_id, an id from list_retailers, or with retailer, a name: matched case-insensitively, or created if it doesn’t exist yet. An id passed as retailer is refused rather than becoming a new shop’s name. Every item line carries its own currency_code; only the order-level currency_code may be omitted, in which case the instance’s reference currency is used.
Lists orders, optionally filtered to pending-only — useful when an agent is matching a shipping notification to an existing order. Use sort=recent to surface the most recently updated orders; use limit to cap the results.
Returns one order in full: header fields, all lines, and current status. This is the starting point for any edit.
Corrects an order’s header fields and/or its line set. Refuses to silently drop lines you didn’t explicitly restate — if you omit a line, the tool asks you to confirm before removing it.
Marks an order as received: applies stock for all inventory lines, and advances each kit line’s kits to Backlog. Accepts an optional arrival date so you can log a delivery after the fact.
Marks an order as shipped: moves the order’s Ordered kits to In Transit. Accepts an optional ship date for shipping notifications logged after the fact. Never touches stock — that only happens on receipt.