@phenomenalorg/mcp 0.5.122 → 0.5.124

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.122",
+  "version": "0.5.124",
   "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 · 226 actions · 5 prompts · fingerprint `c1604b9d`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `667a0ecd`._
 
-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 · 226 actions · 5 prompts · fingerprint `c1604b9d`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `667a0ecd`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -15,7 +15,7 @@ Prefer a curated tool when one covers what you need: it is one call instead of t
 
 **(confirm)** marks an action that sends mail, moves money, publishes something publicly, deletes something, changes who can do what, or changes the organization's web address. Those change nothing until a person has said yes in words. Every action is subject to your role in the organization regardless; the confirm gate is about being asked, not about being allowed.
 
-Areas: account, brand, broadcasts, connections, domains, drive, email-preferences, events, forms, groups, inbox, inventory, knowledge, looks, media, meetings, members, money, notebook, orders, organization, pages, requests, reusable-content, store, tasks, tickets.
+Areas: account, billing, brand, broadcasts, connections, domains, drive, email-preferences, events, forms, groups, inbox, inventory, knowledge, looks, media, meetings, members, money, notebook, orders, organization, pages, requests, reusable-content, store, tasks, tickets.
 
 ## account
 
@@ -23,6 +23,13 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 - `removePasskey` **(confirm)** — Remove one of your own passkeys.
 - `updateMyProfile` — Change your own name and preferred language.
 
+## billing
+
+- `copyBillingProgram` — Open the same billing program for a new period (next school year, next season), carrying its plans, early-payment discounts, late fee and standing rules, with every due date moved to the new period.
+- `createBillingProgram` — Open a recurring billing program (tuition, dues, membership, camp) for one period in one currency (ISO 4217, e.g.
+- `setBillingProgramSettings` — Replace a billing program's rules: payment plans with due dates, early-payment discounts, the late fee, the carry-forward threshold and the standing bands.
+- `updateBillingProgram` — Rename a billing program or change its period.
+
 ## brand
 
 - `activateBrandKit` **(confirm)** — Make a saved brand kit the organization's live one.
@@ -132,7 +139,7 @@ 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.
+- `requestMaterialsBatch` — Ask for materials in one request with several lines, with a purpose, a class or grade and a needed-by date at least the organization’s materials lead time 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).
@@ -231,6 +238,14 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 
 ## money
 
+- `addBillingNote` — Add a shared staff note to a billing account: a note, a logged call, “calling now” to claim the call, or the day the family got in touch before a due date.
+- `attributeBillingPayment` — Say which payer made a payment that was recorded as “not sure”.
+- `closeBillingReview` — Close a staged billing account with what the committee decided.
+- `decideBillingProposal` **(confirm)** — Approve or decline a proposed late fee or suspension.
+- `recordBillingPayment` **(confirm)** — Record money that arrived on a billing account, from any rail (bank transfer, Stripe, cash, check), against the charges it pays, oldest due first.
+- `runBillingSweep` — Run today’s billing check now: propose late fees and suspensions from each program’s settings.
+- `sendBillingNotices` **(confirm)** — Send the first payment notices due today to each late account’s own payers, once per installment.
+- `stageBillingAccount` — Put a billing account on the committee’s list (“Stage for committee”).
 - `startPayout` **(confirm)** — Prefer the `start_payout` tool. Pay the available Stripe balance out to the organization's bank account.
 - `startStripeOnboarding` **(confirm)** — Begin Stripe onboarding for the organization and return the link to finish it.
 
@@ -286,8 +301,9 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 - `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 11 days ahead).
+- `requestPurchase` — Ask for something to be bought for yourself: what, how many, and the date it is needed by (at least the organization’s purchase lead time ahead).
 - `requestTimeOff` — Ask for time off for yourself (a day, part of a day, or a few days).
+- `setProcessSettings` — Replace the organization's back-office rules for time off (the longest request in days), purchases and materials (how many days ahead, calendar or business days, the delivery weekdays 1 = Monday to 7 = Sunday; for purchases the largest quote).
 
 ## 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 · 226 actions · 5 prompts · fingerprint `c1604b9d`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `667a0ecd`._
 
 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 · 226 actions · 5 prompts · fingerprint `c1604b9d`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `667a0ecd`._
 
 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 · 226 actions · 5 prompts · fingerprint `c1604b9d`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `667a0ecd`._
 
 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.
@@ -609,7 +610,7 @@ Every action Phenomenal can take that the curated tools do not already cover, as
 
 **Arguments**
 
-- `area` (string (account | brand | broadcasts | connections | domains | drive | email-preferences | events | forms | groups | inbox | inventory | knowledge | looks | media | meetings | members | money | notebook | orders | organization | pages | requests | reusable-content | store | tasks | tickets)) — Only actions in this part of Phenomenal.
+- `area` (string (account | billing | brand | broadcasts | connections | domains | drive | email-preferences | events | forms | groups | inbox | inventory | knowledge | looks | media | meetings | members | money | notebook | orders | organization | pages | requests | reusable-content | store | tasks | tickets)) — Only actions in this part of Phenomenal.
 - `search` (string) — Only actions whose name or summary contains this word.
 
 ### `describe_mutation`