@phenomenalorg/mcp 0.5.9 → 0.5.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.9",
+  "version": "0.5.10",
   "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: 47 tools · 171 actions · 5 prompts · fingerprint `f3ec65c7`._
+_Tool surface: 48 tools · 180 actions · 5 prompts · fingerprint `5ca86a2e`._
 
 You are connected to Phenomenal, the platform for this PTO'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: 47 tools · 171 actions · 5 prompts · fingerprint `f3ec65c7`._
+_Tool surface: 48 tools · 180 actions · 5 prompts · fingerprint `5ca86a2e`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -70,13 +70,19 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 
 - `createEvent` — Prefer the `create_event` tool. Create an event.
 - `createTicketType` — Add a ticket type (price, capacity) to an event.
+- `createVolunteerRole` — Create a volunteer role on an event — the job itself, like 'Ticket table'.
+- `createVolunteerShift` — Add a shift to a volunteer role: a start, an end, and how many people are needed.
 - `deleteEvent` **(confirm)** — Delete an event and its ticket types.
 - `deleteTicketType` **(confirm)** — Delete a ticket type from an event.
+- `deleteVolunteerRole` **(confirm)** — Remove a role, its shifts and everyone signed up for them.
+- `deleteVolunteerShift` **(confirm)** — Remove one shift and everyone signed up for it.
 - `setEventPublished` **(confirm)** — Prefer the `set_event_published` tool. Publish or unpublish an event.
 - `setEventVisibility` **(confirm)** — Set who can see an event — everyone, members, or one group.
 - `translateEvent` — Fill in an event's missing translations for the organization's languages.
 - `updateEvent` — Prefer the `update_event` tool. Change an event — time, place, description, page content.
 - `updateTicketType` — Change a ticket type's name, price, capacity or availability.
+- `updateVolunteerRole` — Change a volunteer role's name or description.
+- `updateVolunteerShift` — Change a shift's times or how many people are needed.
 
 ## forms
 
@@ -252,7 +258,10 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 
 ## tickets
 
+- `cancelMyBooking` — Cancel a booking you made yourself.
 - `checkInTicket` — Check a ticket in at the door by its code.
+- `claimShift` — Take a seat on a volunteer shift, as yourself.
 - `compTickets` **(confirm)** — Issue free tickets to someone for an event.
 - `refundTicketOrder` **(confirm)** — Prefer the `refund_ticket_order` tool. Refund a ticket order in full and void its tickets.
+- `releaseShift` — Give up a volunteer shift you claimed yourself.
 - `undoCheckIn` — Undo a ticket check-in at the door.

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: 47 tools · 171 actions · 5 prompts · fingerprint `f3ec65c7`._
+_Tool surface: 48 tools · 180 actions · 5 prompts · fingerprint `5ca86a2e`._
 
 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: 47 tools · 171 actions · 5 prompts · fingerprint `f3ec65c7`._
+_Tool surface: 48 tools · 180 actions · 5 prompts · fingerprint `5ca86a2e`._
 
 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: 47 tools · 171 actions · 5 prompts · fingerprint `f3ec65c7`._
+_Tool surface: 48 tools · 180 actions · 5 prompts · fingerprint `5ca86a2e`._
 
 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.
 
@@ -169,7 +169,7 @@ Read one authorized reusable composition and exact revision with complete blocks
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
-- `contentId` (string, required)
+- `contentId` (string, required) — The id of the saved piece, from list_reusable_content. Not a page or event id.
 - `revisionId` (string) — Optional exact immutable revision id.
 
 ### `save_reusable_content_new`
@@ -182,7 +182,7 @@ Save a new private reusable-content identity from complete canonical blocks. It
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
 - `ownerGroupId` (any)
-- `name` (string, required)
+- `name` (string, required) — What an officer will see this saved piece called in the library — a short human name, not a slug.
 - `description` (string)
 - `blocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
 - `initialUseAudience` (string, required) — public, members, or group:<uuid>.
@@ -197,9 +197,9 @@ Append one immutable complete-block revision under exact revision and policy com
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
-- `contentId` (string, required)
-- `expectedRevisionId` (string, required)
-- `expectedPolicyVersion` (integer, required)
+- `contentId` (string, required) — The saved piece to write a new revision of, from list_reusable_content.
+- `expectedRevisionId` (string, required) — The revision you READ, from get_reusable_content. The write is refused if somebody else saved since — send the value you were given, never one you composed.
+- `expectedPolicyVersion` (integer, required) — The policy version you READ, from get_reusable_content. Guards the same write against a sharing-policy change; send the value you were given.
 - `blocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
 - `idempotencyKey` (string, required) — A caller-stable key for this exact input.
 
@@ -212,13 +212,13 @@ Read source and destination state first, then create actor-bound 30-minute stagi
 **Arguments**
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
-- `contentId` (string, required)
+- `contentId` (string, required) — The saved piece to copy FROM, from list_reusable_content.
 - `revisionId` (string) — Optional exact source revision. Reuse the returned source.revisionId on retry.
-- `destination` (object, required)
-- `expectedDestinationToken` (string, required)
+- `destination` (object, required) — Where the copy lands: the kind of surface and that surface’s own id.
+- `expectedDestinationToken` (string, required) — The destination token you READ for this surface. The copy is refused if the destination changed since — send the value you were given, never one you composed.
 - `destinationAudience` (string, required) — public, members, or group:<uuid>.
 - `candidateBlocks` (array, required) — The complete canonical Phenomenal block array, including every locale and child.
-- `insertionIndex` (integer, required)
+- `insertionIndex` (integer, required) — Where in the destination the copied blocks go: 0 puts them first, and the destination’s current block count puts them last.
 - `idempotencyKey` (string, required) — A caller-stable key for this exact prepare.
 
 ### `draft_page`
@@ -338,6 +338,16 @@ The groups in a Phenomenal organization — classes, committees, teams — with
 
 - `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
 
+### `groups_i_can_join`
+
+The groups at this school that a family can join themselves — clubs, committees and volunteer teams the school opened to anyone. Use this before joinGroup: it is the only way to find a group by what it is about rather than by its exact name. Groups an administrator manages are not here and cannot be joined this way. "joined" says whether this person is already in one.
+
+**Hints:** read-only, idempotent. **Confirm:** not required.
+
+**Arguments**
+
+- `orgId` (string) — The organization to act for — an id from list_my_orgs. Never invent one; if you are unsure which, ask the person.
+
 ### `list_group_members`
 
 Who is in one Phenomenal group, with each person's relation to it (member, steward) and whether they are still active.