@phenomenalorg/mcp 0.5.123 → 0.5.125

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.123",
+  "version": "0.5.125",
   "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,7 +8,7 @@ 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 `3e073640`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `6f1f52d9`._
 
 You are connected to Phenomenal, the platform for this organization's site, members, events, tickets, email, forms, store and money.
 

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 `3e073640`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `6f1f52d9`._
 
 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 `3e073640`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `6f1f52d9`._
 
 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 `3e073640`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `6f1f52d9`._
 
 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.
 

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 `3e073640`._
+_Tool surface: 51 tools · 239 actions · 5 prompts · fingerprint `6f1f52d9`._
 
 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.
 
@@ -610,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`