@phenomenalorg/mcp 0.5.181 → 0.5.184

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.181",
+  "version": "0.5.184",
   "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 an organization in Phenomenal —
 <!-- 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: 52 tools · 331 actions · 5 prompts · fingerprint `c9242679`._
+_Tool surface: 52 tools · 338 actions · 5 prompts · fingerprint `0f576e9b`._
 
 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: 52 tools · 331 actions · 5 prompts · fingerprint `c9242679`._
+_Tool surface: 52 tools · 338 actions · 5 prompts · fingerprint `0f576e9b`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -92,6 +92,8 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 
 ## events
 
+- `askEventSignupQuestion` — Write one question to ask when someone signs up for any job on an event (for example "Anything you’d like to make sure we cover?"), in each language the organization uses.
+- `askVolunteerRoleQuestion` — Write one question to ask when someone signs up for a volunteer job or conference time (for example "Anything you’d like to make sure we cover?"), in each language the organization uses.
 - `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'.
@@ -105,7 +107,9 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 - `setEventParticipationGoal` — Set or clear an event’s sign-up goal (in households) and the earlier event its sign-ups are compared with.
 - `setEventPublished` **(confirm)** — Prefer the `set_event_published` tool. Publish or unpublish an event.
 - `setEventRules` — Make this the default: how long a NEW volunteer job’s shift runs (`shiftMinutes`: 15 to 720 minutes in quarter hours from the event’s start, or null for the event’s hours, the starting rule) and how many people it takes (`shiftPeople`: 1 to 500, 2 to start).
+- `setEventSignupForm` — Ask an existing form’s questions when someone signs up for any job on an event (help jobs and conference times) that has no question of its own, or with `formId: null` stop asking.
 - `setEventVisibility` **(confirm)** — Set who can see an event — everyone, members, or one group — and, with `listed: false`, make it unlisted: open to anyone with its link or QR code but left out of the calendar, the events list, calendar feeds, the member dashboard and newsletters.
+- `setVolunteerRoleForm` — Ask an existing form’s questions when someone signs up for a volunteer job or conference time, or with `formId: null` stop asking.
 - `suggestVolunteerJobTranslations` — Translate a volunteer job's name and description into the organization's other languages.
 - `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.
@@ -166,7 +170,7 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 - `deliverMaterialsRequest` — Mark a pending materials request delivered.
 - `recordStockCount` — Save a stock count of several inventory items at once (after scanning a shelf): each line sets on hand to what is on the shelf, written to the stock ledger; an item that drops below its reorder level raises a reorder.
 - `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 the organization’s materials lead time 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 (read `materialsEarliestNeededBy` on the org).
 - `saveStockItem` — Create or edit an inventory catalog item (name, category, unit, location, reorder level, and its product or book barcode).
 - `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).
@@ -333,6 +337,7 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 - `setOrgDefaultLanguage` **(confirm)** — Set the organization's default site language.
 - `setOrgJoinPolicy` **(confirm)** — Set whether people can request to join the organization themselves.
 - `setOrgLanguages` **(confirm)** — Set which languages the site is offered in, as a comma-separated list.
+- `setOrgType` — Change the organization’s type: district, school, club or publisher.
 - `suggestOrgTheme` — Suggest theme colors and fonts from a description.
 - `updateOrg` **(confirm)** — Change the organization's name, contact email, postal address or home page.
 - `updateOrgChrome` — Replace the site's header and footer content.
@@ -366,6 +371,7 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 ## requests
 
 - `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.
+- `addWorkItemPicture` — Add a picture to a request (a receipt, the delivered item, what is needed).
 - `approveCommitteePurchases` **(confirm)** — Approve several purchases waiting for the purchase committee at once.
 - `archiveProcessDefinition` — Archive a back-office process.
 - `cancelFormRequest` — Withdraw an open form request: the member can no longer send it, it leaves their Inbox and its reminders stop.
@@ -377,6 +383,7 @@ Areas: account, automations, billing, brand, broadcasts, connections, domains, d
 - `markWorkItemNotesRead` — Mark your own unread note messages for one back-office request read, once you have read it.
 - `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".
 - `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`.
+- `removeWorkItemPicture` **(confirm)** — Remove one picture from a request, for example a wrong photo of a student or an ID card.
 - `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).
 - `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).
 - `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.

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: 52 tools · 331 actions · 5 prompts · fingerprint `c9242679`._
+_Tool surface: 52 tools · 338 actions · 5 prompts · fingerprint `0f576e9b`._
 
 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: 52 tools · 331 actions · 5 prompts · fingerprint `c9242679`._
+_Tool surface: 52 tools · 338 actions · 5 prompts · fingerprint `0f576e9b`._
 
 Phenomenal runs an organization: its public website, its member roster, its events and tickets, its email to members, 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: 52 tools · 331 actions · 5 prompts · fingerprint `c9242679`._
+_Tool surface: 52 tools · 338 actions · 5 prompts · fingerprint `0f576e9b`._
 
 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.