@phenomenalorg/mcp 0.5.51 → 0.5.53

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.51",
+  "version": "0.5.53",
   "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: 49 tools · 197 actions · 5 prompts · fingerprint `60e38be1`._
+_Tool surface: 49 tools · 198 actions · 5 prompts · fingerprint `719b2c7c`._
 
 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: 49 tools · 197 actions · 5 prompts · fingerprint `60e38be1`._
+_Tool surface: 49 tools · 198 actions · 5 prompts · fingerprint `719b2c7c`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -156,6 +156,7 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 - `learnAsset` — Index a file's contents so the assistant can answer from it.
 - `redescribeAsset` — Regenerate a file's AI description and alt text.
 - `setAssetAudience` **(confirm)** — Change who can see an uploaded file — the public, or members only.
+- `suggestAssetAlt` — Suggest a picture's description (alt text) from what the assistant read in it, in the given language and the organization's other languages.
 - `updateAsset` — Change an uploaded file's title, alt text, classification or scope.
 - `uploadAsset` **(confirm)** — Prefer the `add_media` tool. Add a picture or document to the media library by sending the file itself, base64-encoded, for anything under about 4 MB.
 

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: 49 tools · 197 actions · 5 prompts · fingerprint `60e38be1`._
+_Tool surface: 49 tools · 198 actions · 5 prompts · fingerprint `719b2c7c`._
 
 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: 49 tools · 197 actions · 5 prompts · fingerprint `60e38be1`._
+_Tool surface: 49 tools · 198 actions · 5 prompts · fingerprint `719b2c7c`._
 
 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: 49 tools · 197 actions · 5 prompts · fingerprint `60e38be1`._
+_Tool surface: 49 tools · 198 actions · 5 prompts · fingerprint `719b2c7c`._
 
 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.
 
@@ -374,20 +374,20 @@ List compact broadcast summaries for a Phenomenal organization. Pass broadcastId
 
 ### `draft_broadcast`
 
-Create an email broadcast draft, or explicitly save complete prepared bodyBlocks into an existing draft with its exact revision and pendingCopies. SENDS NOTHING in either mode.
+Create an email broadcast draft, or save into an existing one: pass broadcastId with the subject and body to rewrite the message that draft carries. Prepared reusable content is the separate existing-draft shape and needs bodyBlocks, expectedRevision and pendingCopies together. SENDS NOTHING in any mode.
 
 **Hints:** writes. **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.
-- `broadcastId` (string) — Existing draft id. Omit to create a new markdown draft.
-- `subject` (string) — The subject line families will see.
-- `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.
+- `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.
+- `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. 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.
-- `bodyBlocks` (array) — Complete prepared block-body candidate for existing-draft mode only.
-- `expectedRevision` (string) — Exact revision used to prepare this existing broadcast draft.
+- `bodyBlocks` (array) — Complete prepared block-body candidate. Only for a prepared reusable-content save, and only together with expectedRevision and pendingCopies — to write ordinary prose, pass body instead.
+- `expectedRevision` (string) — Exact revision used to prepare this existing broadcast draft. Only together with bodyBlocks and pendingCopies.
 - `pendingCopies` (array) — Exact pendingCopy receipt(s) from prepare_reusable_content_copy. cancelledRootIds may contain only deliberately removed inserted roots.
 
 ### `send_broadcast_test`