@phenomenalorg/mcp 0.5.168 → 0.5.170

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@phenomenalorg/mcp",
3
- "version": "0.5.168",
3
+ "version": "0.5.170",
4
4
  "type": "module",
5
5
  "description": "Phenomenal MCP bridge — connects a stdio-only MCP client to the Phenomenal MCP server over Streamable HTTP, with browser sign-in.",
6
6
  "license": "MIT",
package/skill/SKILL.md CHANGED
@@ -8,7 +8,7 @@ description: Use when the user wants to manage a PTO, school or club in Phenomen
8
8
  <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
9
9
  gate fails when these files are not what the registry currently says. -->
10
10
 
11
- _Tool surface: 51 tools · 305 actions · 5 prompts · fingerprint `acd89548`._
11
+ _Tool surface: 52 tools · 311 actions · 5 prompts · fingerprint `08f0248d`._
12
12
 
13
13
  You are connected to Phenomenal, the platform for this organization's site, members, events, tickets, email, forms, store and money.
14
14
 
@@ -3,7 +3,7 @@
3
3
  <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
4
4
  gate fails when these files are not what the registry currently says. -->
5
5
 
6
- _Tool surface: 51 tools · 305 actions · 5 prompts · fingerprint `acd89548`._
6
+ _Tool surface: 52 tools · 311 actions · 5 prompts · fingerprint `08f0248d`._
7
7
 
8
8
  The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
9
9
 
@@ -245,6 +245,7 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
245
245
  - `saveMinutesTranslation` — Save an enabled-language translation of the meeting minutes draft for reviewer approval.
246
246
  - `setActiveItem` — Make an agenda item the one the live meeting is on.
247
247
  - `setAttendance` — Record whether a member is present at a meeting.
248
+ - `setMeetingCameraPolicy` — Choose who may turn a camera on in a meeting: off, officers or everyone.
248
249
  - `setMeetingSecretary` **(confirm)** — Hand a meeting to another admin or owner to run.
249
250
  - `setMeetingSpeakerName` — Name one diarized voice in a meeting transcript (spanId + provider label) as an org member or a typed guest name; it applies to every line with that label in that stream.
250
251
  - `setMinutesReadyNotify` — Ask, or stop asking, to be emailed a link when an adjourned meeting's minutes draft finishes compiling.
@@ -349,21 +350,26 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
349
350
 
350
351
  - `addWorkItemNote` — Add a note to a back-office request: the requester and the staff of its process write to each other on it, and staff may add a staff-only note the requester never sees.
351
352
  - `approveCommitteePurchases` **(confirm)** — Approve several purchases waiting for the purchase committee at once.
353
+ - `archiveProcessDefinition` — Archive a back-office process.
352
354
  - `cancelFormRequest` — Withdraw an open form request: the member can no longer send it, it leaves their Inbox and its reminders stop.
353
355
  - `cancelPurchaseRequest` — Withdraw your own purchase request while the purchaser is still picking it up or quoting it.
354
356
  - `cancelReimbursementRequest` — Withdraw your own reimbursement request while it is still waiting to be authorized.
355
357
  - `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).
356
358
  - `decideWorkItem` — Approve or deny a request waiting for approval, such as a teacher’s time off or a quoted purchase.
359
+ - `discardProcessDraft` — Throw away the unpublished names of a back-office process; the live version stays.
357
360
  - `markWorkItemNotesRead` — Mark your own unread note messages for one back-office request read, once you have read it.
358
361
  - `recordPurchaseQuote` — Record the supplier and the quoted amount for a purchase request in the organization’s currency (USD or CRC), in minor units (cents or céntimos) as a string: ₡25,000 is amountMinor "2500000" and $45.50 is "4550", not "25000".
359
- - `recordSubstitute` — Record who covers an approved time-off request.
362
+ - `recordSubstitute` — Record who covers an approved time-off request: a member of the organization (`substituteMembershipId`, from `coverCandidates` on the request; never the requester) or, for someone outside it, `substituteName`.
360
363
  - `requestForm` **(confirm)** — Ask one member to fill in one published form about a back-office request, with a due date and up to 3 reminders (days before it, 1–30).
361
364
  - `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).
362
365
  - `requestReimbursement` — Ask to buy something urgent yourself and be paid back: what, why it cannot wait, about how much in minor units (céntimos for CRC) as a string, and the date it is needed by.
363
366
  - `requestTimeOff` — Ask for time off for yourself (a day, part of a day, or a few days).
367
+ - `saveProcessDraft` — Save new names and descriptions for a back-office process and its steps, in each language, as an unpublished draft (`draft`: { title_i18n, description_i18n, steps: { <stepKey>: { label_i18n, description_i18n } } }, each text a { en, es, fr, pt } map; names at most 120 characters, descriptions 1,000; blank means Phenomenal’s wording).
364
368
  - `setMaterialsRequesterCannotDeliver` — Turn on or off whether the person who asked for a materials line may also be the one who delivers it (off by default: they may).
365
369
  - `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, as amountMaxMinor in minor units (céntimos): a cap of ₡1,000,000,000 is “100000000000”; the older amountMax takes whole units).
366
370
  - `setRuleConstraint` — Set, change or remove a floor or lock on a back-office rule of every organization BELOW this one (a district for its schools and clubs, a school for its clubs): `materials-notice`/`purchase-notice` `minLeadDays` (floor: at least N calendar days), `materials-too-soon`/`purchase-too-soon` `leadTimeMode` (lock: refuse or warn), `materials-self` `requesterCannotDeliver` (lock), `time-off-max` `maxDays` (ceiling), `reimbursement-tolerance` `tolerancePercent` (ceiling; the owner only).
371
+ - `suggestProcessNameTranslations` — Translate a back-office process’s draft names and descriptions into the organization’s other languages, filling only languages that are still empty (typed words are never replaced).
372
+ - `unarchiveProcessDefinition` — Bring an archived back-office process back.
367
373
  - `updateMaterialsLineDetails` — Change the brand and specs on your own line of a materials request that is not in the catalog, while the purchaser is still picking it up or quoting it.
368
374
 
369
375
  ## reusable-content
@@ -3,7 +3,7 @@
3
3
  <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
4
4
  gate fails when these files are not what the registry currently says. -->
5
5
 
6
- _Tool surface: 51 tools · 305 actions · 5 prompts · fingerprint `acd89548`._
6
+ _Tool surface: 52 tools · 311 actions · 5 prompts · fingerprint `08f0248d`._
7
7
 
8
8
  Two tools answer questions no curated tool anticipated.
9
9
 
@@ -3,7 +3,7 @@
3
3
  <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
4
4
  gate fails when these files are not what the registry currently says. -->
5
5
 
6
- _Tool surface: 51 tools · 305 actions · 5 prompts · fingerprint `acd89548`._
6
+ _Tool surface: 52 tools · 311 actions · 5 prompts · fingerprint `08f0248d`._
7
7
 
8
8
  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.
9
9
 
@@ -3,7 +3,7 @@
3
3
  <!-- Generated from the Phenomenal tool registry. Do not edit by hand: a drift
4
4
  gate fails when these files are not what the registry currently says. -->
5
5
 
6
- _Tool surface: 51 tools · 305 actions · 5 prompts · fingerprint `acd89548`._
6
+ _Tool surface: 52 tools · 311 actions · 5 prompts · fingerprint `08f0248d`._
7
7
 
8
8
  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.
9
9
 
@@ -561,6 +561,18 @@ The answers people have submitted to a Phenomenal form, newest first, with who s
561
561
  - `limit` (integer) — How many to return (1–100, default 25).
562
562
  - `cursor` (string) — The nextCursor from a previous call.
563
563
 
564
+ ### `form_not_submitted`
565
+
566
+ Who in one Phenomenal group (and the groups under it) has not submitted one form yet: their names and the counts, never their answers or addresses. For "third grade, who hasn’t submitted the waiver?". Group leaders are not listed. These are family names — keep them inside your answer to the officer and do not repeat them elsewhere.
567
+
568
+ **Hints:** read-only, idempotent. **Confirm:** not required.
569
+
570
+ **Arguments**
571
+
572
+ - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
573
+ - `formId` (string, required) — From list_forms.
574
+ - `groupId` (string, required) — From list_groups.
575
+
564
576
  ### `find_media`
565
577
 
566
578
  Find photos and files in a Phenomenal organization's media library by what is in them. Returns the STORED PATH of each file, which is what page blocks and events refer to — not a public link, and not something to paste into a message.