@phenomenalorg/mcp 0.5.121 → 0.5.123

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.121",
+  "version": "0.5.123",
   "type": "module",
   "description": "Phenomenal MCP bridge — connects a stdio-only MCP client to the Phenomenal MCP server over Streamable HTTP, with browser sign-in.",
   "license": "MIT",

package/skill/SKILL.md

@@ -8,9 +8,9 @@ description: Use when the user wants to manage a PTO, school or club in Phenomen
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 51 tools · 224 actions · 5 prompts · fingerprint `a15c3d50`._
+_Tool surface: 51 tools · 226 actions · 5 prompts · fingerprint `3e073640`._
 
-You are connected to Phenomenal, the platform for this PTO's site, members, events, tickets, email, forms, store and money.
+You are connected to Phenomenal, the platform for this organization's site, members, events, tickets, email, forms, store and money.
 
 Start with list_my_orgs. Every organization id comes from it; never guess or invent one. Name the selected organization; ask if ambiguous.
 
@@ -20,7 +20,7 @@ For any tool with confirm, first call WITHOUT confirm. Present the returned acti
 
 Mail and money are one-way. Slow down before sending, refunding or paying out.
 
-Keep member names, addresses and form answers in your answer to the officer, never on public pages or broadcasts. Write warm, plain US English for parents on phones. On FORBIDDEN, explain the role limit and stop.
+Keep member names, addresses and form answers in your answer to the officer, never on public pages or broadcasts. Write warm, plain US English for the organization’s members on phones. On FORBIDDEN, explain the role limit and stop.
 
 Looks are the default for new page-wide styling: get_page_authoring_state → DRAFT preview → save_page_changes (private) → get_page_authoring_state to read the canonical save → PUBLISH preview → publish_page. Use complete content and exact revisions/digests; legacy tools remain compatible.
 

package/skill/references/mutations.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 51 tools · 224 actions · 5 prompts · fingerprint `a15c3d50`._
+_Tool surface: 51 tools · 226 actions · 5 prompts · fingerprint `3e073640`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -65,8 +65,8 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 
 - `disconnectGoogleDrive` — Disconnect the organization's Google Drive.
 - `exportDriveCsv` — Export a Google Drive spreadsheet as CSV text for import.
-- `importDriveFiles` — Import chosen Google Drive files into the knowledge base at a classification and scope.
-- `importDriveFolder` — Import a whole Google Drive folder into the knowledge base, optionally including subfolders.
+- `importDriveFiles` — Import chosen Google Drive files (documents or images) into the knowledge base, for whoever you choose, down to group stewards only (scope `role:stewards`, classification `restricted`).
+- `importDriveFolder` — Import a whole Google Drive folder into the knowledge base, optionally including subfolders, for whoever you choose, down to group stewards only (scope `role:stewards`, classification `restricted`).
 
 ## email-preferences
 
@@ -132,16 +132,17 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 - `cancelMaterialsRequest` — Cancel a pending materials request — your own, or any request if you deliver materials.
 - `deliverMaterialsRequest` — Mark a pending materials request delivered.
 - `requestMaterials` — Ask for materials from the org's inventory catalog (item + quantity, optional needed-by date and a note like the room).
+- `requestMaterialsBatch` — Ask for materials in one request with several lines, with a purpose, a class or grade and a needed-by date at least 11 days ahead.
 - `saveStockItem` — Create or edit an inventory catalog item (name, category, unit, location, reorder level).
 - `setStockCategoryLevel` — Set a category's default reorder level for the inventory, or clear it with null.
 - `setStockReorderStatus` — Move a reorder on the stock keeper's board: open → ordered → received (or dismissed).
 
 ## knowledge
 
-- `addDocument` — Add a document to the organization's knowledge base so the assistant can answer from it.
+- `addDocument` — Add a document to the organization's knowledge base so the assistant can answer from it, for whoever you choose, down to group stewards only (scope `role:stewards`, classification `restricted`).
 - `askOrg` — Prefer the `ask_org` tool. Ask a question and get an answer drawn from the organization's own records — uploaded documents, pictures and files in the library, meeting minutes, motions, tasks, meeting transcripts, messages the organization has sent, published pages on its website, events, saved group chats, approved meeting summaries and approved meeting findings — with citations.
 - `deleteDocument` **(confirm)** — Delete a document from the organization's knowledge base.
-- `importUploadedDocument` — Import a document from pasted text into the knowledge base.
+- `importUploadedDocument` — Import a document from pasted text into the knowledge base, for whoever you choose, down to group stewards only (scope `role:stewards`, classification `restricted`).
 - `learnAgain` — Re-index one knowledge source so the assistant picks up its current contents.
 - `reclassifyDocument` **(confirm)** — Change who a knowledge document can be shown to.
 - `relearnKnowledge` — Bring a retired knowledge source back into the assistant's answers.
@@ -280,11 +281,12 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 
 ## requests
 
+- `cancelPurchaseRequest` — Withdraw your own purchase request while the purchaser is still picking it up or quoting it.
 - `completePurchaseStep` — Move a purchase request on: pick it up, mark it ordered once approved, or mark it received (which closes it and tells the requester).
 - `decideWorkItem` — Approve or deny a request waiting for approval, such as a teacher’s time off or a quoted purchase.
 - `recordPurchaseQuote` — Record the supplier and the quoted amount in whole Costa Rican colones for a purchase request.
 - `recordSubstitute` — Record who covers an approved time-off request.
-- `requestPurchase` — Ask for something to be bought for yourself: what, how many, and the date it is needed by (at least 8 days ahead).
+- `requestPurchase` — Ask for something to be bought for yourself: what, how many, and the date it is needed by (at least 11 days ahead).
 - `requestTimeOff` — Ask for time off for yourself (a day, part of a day, or a few days).
 
 ## reusable-content

package/skill/references/schema.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 51 tools · 224 actions · 5 prompts · fingerprint `a15c3d50`._
+_Tool surface: 51 tools · 226 actions · 5 prompts · fingerprint `3e073640`._
 
 Two tools answer questions no curated tool anticipated.
 

package/skill/references/starting-doc.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 51 tools · 224 actions · 5 prompts · fingerprint `a15c3d50`._
+_Tool surface: 51 tools · 226 actions · 5 prompts · fingerprint `3e073640`._
 
 Phenomenal runs a school's PTO: its public website, its member roster, its events and tickets, its email to families, its forms, its store and its money. It exposes all of that over the Model Context Protocol, so an assistant an officer already uses can do the work with them.
 
@@ -55,7 +55,7 @@ That writes a `phenomenal/` folder — `SKILL.md` plus its reference sheets —
 
 ## How to work in Phenomenal
 
-You are connected to Phenomenal, the platform for this PTO's site, members, events, tickets, email, forms, store and money.
+You are connected to Phenomenal, the platform for this organization's site, members, events, tickets, email, forms, store and money.
 
 Start with list_my_orgs. Every organization id comes from it; never guess or invent one. Name the selected organization; ask if ambiguous.
 
@@ -65,7 +65,7 @@ For any tool with confirm, first call WITHOUT confirm. Present the returned acti
 
 Mail and money are one-way. Slow down before sending, refunding or paying out.
 
-Keep member names, addresses and form answers in your answer to the officer, never on public pages or broadcasts. Write warm, plain US English for parents on phones. On FORBIDDEN, explain the role limit and stop.
+Keep member names, addresses and form answers in your answer to the officer, never on public pages or broadcasts. Write warm, plain US English for the organization’s members on phones. On FORBIDDEN, explain the role limit and stop.
 
 Looks are the default for new page-wide styling: get_page_authoring_state → DRAFT preview → save_page_changes (private) → get_page_authoring_state to read the canonical save → PUBLISH preview → publish_page. Use complete content and exact revisions/digests; legacy tools remain compatible.
 

package/skill/references/tools.md

@@ -3,7 +3,7 @@
 <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
      gate fails when these files are not what the registry currently says. -->
 
-_Tool surface: 51 tools · 224 actions · 5 prompts · fingerprint `a15c3d50`._
+_Tool surface: 51 tools · 226 actions · 5 prompts · fingerprint `3e073640`._
 
 Every tool the Phenomenal MCP server offers, in the order a client lists them. `list_my_orgs` is first because every other tool needs an organization id from it.
 
@@ -385,6 +385,7 @@ Create an email broadcast draft, or save into an existing one: pass broadcastId
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
 - `broadcastId` (string) — Existing draft to save into. Omit to create a new draft.
 - `subject` (string) — The subject line families will see. Saving an existing draft without it leaves the stored subject alone.
+- `subjectByLanguage` (object) — The subject written in each OTHER language this draft goes out in, keyed by language code (e.g. {"es": "…"}), each written in that language and saying the same thing as `subject` — never the English copied. Required with a new subject when the draft also carries another language.
 - `body` (string) — The message, in Markdown. Write it the way a parent would want to read it — short, warm, and clear about dates and what to do. EVERY SECTION HEADER IS ITS OWN `## Heading` LINE — the ones you write yourself exactly as much as the ones from a document that was brought in. Never fold one into the paragraph beneath it as a bold lead-in (`**Main lesson** — we continue…`) — a `##` line becomes a section the officer can move, restyle and point at, and it is the only thing that arrives in an inbox as a header; a bold run opening a paragraph is swallowed by that paragraph and becomes nothing. Saving an existing draft without it leaves the stored message alone.
 - `audience` (object) — Who it goes to. Omission selects every member for a new draft, but preserves the stored audience when saving an existing draft.
 - `replyTo` (string) — Where replies go. Optional — the organization's contact address is used otherwise.