@sebamomann/plants-mcp 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 Notable changes to `@sebamomann/plants-mcp`. Versioning is semver against the **tool surface** —
 see the table in `AGENTS.md` for what counts as major, minor, and patch.
 
+## 1.7.0 — 2026-08-08
+
+**New plant status: `EXTERNAL` (reference plant).** A plant somebody else owns, recorded only as
+an anchor for propagation lineage — never cared for, no care settings, not part of the collection.
+`list_plants` accepts it (and `SPLIT`, which the enum had been missing) as a `status` filter, and
+`collection_stats` now excludes `EXTERNAL` plants from every count and total, matching the app's
+`/stats` page. No tool added or removed.
+
 ## 1.6.0 — 2026-08-04
 
 **Plants can now carry freeform tags.** `update_plant` gained a `tags` argument (replaces the

package/README.md

@@ -135,8 +135,10 @@ Not oversights — deliberate limits:
 | `list_plants` | `GET /api/v1/plants` | all optional: `status`, `lifecycle`, `locationId`, `plantTypeId`, `soilId`, `fertilizerId`, `tag` (exact match), `search` (type name / notes), `limit` (1–200), `offset`, `sort` |
 | `get_plant` | `GET /api/v1/plants/:id` | `id` **(required)** — full detail: catalogs, care config, lineage, recent events |
 
-`status` is one of `LIVING`, `DEAD`, `GIFTED`, `LOST`, `SOLD`, `TRADED`, `MERGED`; `lifecycle` is
-`PROPAGATING` or `ESTABLISHED`.
+`status` is one of `LIVING`, `DEAD`, `GIFTED`, `LOST`, `SOLD`, `TRADED`, `MERGED`, `SPLIT`,
+`EXTERNAL`; `lifecycle` is `PROPAGATING` or `ESTABLISHED`. `EXTERNAL` is a **reference plant** —
+somebody else's plant, recorded only as an anchor for propagation lineage. It is never cared for,
+never appears in due/overdue care, and is excluded from `collection_stats`.
 
 ### Per-plant history
 
@@ -193,8 +195,9 @@ Use this instead of looping the per-plant tools when the question is about a **t
 
 Counts by status, location, and plant type; total spend (`price`) and total revenue (`soldPrice`
 on sold plants); acquisitions bucketed by month. Use this instead of listing every plant when the
-question is a count or a total, not which specific plants. Every status is included — no `MERGED`
-filter — matching the app's own `/stats` page.
+question is a count or a total, not which specific plants. Every status is included except
+`EXTERNAL` (reference plants aren't yours) — no `MERGED` filter — matching the app's own `/stats`
+page.
 
 | Tool | Endpoint | Arguments |
 |---|---|---|

package/dist/index.js

@@ -121,9 +121,9 @@ server.tool("whoami", "Return the authenticated user for the configured API key.
 // --- Plants -----------------------------------------------------------------
 server.tool("list_plants", "List the user's plants, with optional filters. Returns plant summaries.", {
     status: z
-        .enum(["LIVING", "DEAD", "GIFTED", "LOST", "SOLD", "TRADED", "MERGED"])
+        .enum(["LIVING", "DEAD", "GIFTED", "LOST", "SOLD", "TRADED", "MERGED", "SPLIT", "EXTERNAL"])
         .optional()
-        .describe("Filter by plant status."),
+        .describe("Filter by plant status. EXTERNAL is a reference plant: somebody else's plant, recorded only as an anchor for propagation lineage — never cared for and not part of the collection's totals."),
     lifecycle: z.enum(["PROPAGATING", "ESTABLISHED"]).optional().describe("Filter by lifecycle stage."),
     locationId: z.number().int().optional().describe("Filter by location id."),
     plantTypeId: z.number().int().optional().describe("Filter by plant type (species) id."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sebamomann/plants-mcp",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "MCP server for the Sprig plant app: 29 tools to read a plant collection, log care, and edit a plant. Read-only by default; writes need a write-scoped API key. Two tools can delete a watering/fertilization event; nothing else is destructive.",
   "type": "module",
   "license": "MIT",