@phenomenalorg/mcp 0.5.19 → 0.5.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phenomenalorg/mcp",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "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: 48 tools · 182 actions · 5 prompts · fingerprint `0edc18f6`._
+_Tool surface: 49 tools · 184 actions · 5 prompts · fingerprint `2cbe1bf4`._
 
 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: 48 tools · 182 actions · 5 prompts · fingerprint `0edc18f6`._
+_Tool surface: 49 tools · 184 actions · 5 prompts · fingerprint `2cbe1bf4`._
 
 The curated tools in `references/tools.md` cover the work an officer does most days. Everything else Phenomenal can do is reachable by name:
 
@@ -138,12 +138,14 @@ Areas: account, brand, broadcasts, connections, domains, drive, email-preference
 - `discardEditedImage` — Throw away an AI image edit that was never kept.
 - `editAsset` — Edit a photo with AI from a plain-language instruction.
 - `generateLibraryImage` — Generate a new image for the organization's media library from an instruction.
+- `importAssetFromUrl` **(confirm)** — Prefer the `add_media` tool. Add a picture or document to the media library by fetching it from an https address — the right door for anything already on the web, and for anything too large to send inline.
 - `keepEditedImage` — Save an AI image edit into the organization's media library as a new asset.
 - `keepLibraryImage` — Save a generated image into the organization's media library.
 - `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.
 - `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.
 
 ## meetings
 

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: 48 tools · 182 actions · 5 prompts · fingerprint `0edc18f6`._
+_Tool surface: 49 tools · 184 actions · 5 prompts · fingerprint `2cbe1bf4`._
 
 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: 48 tools · 182 actions · 5 prompts · fingerprint `0edc18f6`._
+_Tool surface: 49 tools · 184 actions · 5 prompts · fingerprint `2cbe1bf4`._
 
 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: 48 tools · 182 actions · 5 prompts · fingerprint `0edc18f6`._
+_Tool surface: 49 tools · 184 actions · 5 prompts · fingerprint `2cbe1bf4`._
 
 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.
 
@@ -548,6 +548,24 @@ Find photos and files in a Phenomenal organization's media library by what is in
 - `kind` (string) — Narrow to one kind, e.g. "image" or "document".
 - `limit` (integer) — How many to return (1–50, default 20).
 
+### `add_media`
+
+Add a picture or document to a Phenomenal organization's media library. Supply EITHER `url` — an https address we fetch the file from, which is the right choice for anything already on the web and for anything large — OR `data`, the file base64-encoded, for a file you have made or hold yourself. Inline files are capped at about 4 MB and cost a great deal of context, so prefer `url` whenever the file is somewhere we can reach. PNG, JPEG, WebP, PDF and Office documents are accepted; SVG is not, and video goes through the separate presigned upload. Returns the STORED PATH to use in a page block — not a public link.
+
+**Hints:** writes. **Confirm:** required — without it you get a preview and nothing changes.
+
+**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.
+- `url` (string) — https address of the file. Use this whenever the file is already on the web.
+- `data` (string) — The file, base64-encoded (a data: URL is also accepted). Only for a file you hold yourself and that is under about 4 MB — otherwise host it and pass `url`.
+- `contentType` (string) — Required with `data`, e.g. "image/png". Ignored with `url`.
+- `audience` (string, required) — Who may see the file: "public" (anyone on the internet, forever), "members", or "group:<groupId>". Required — there is deliberately no default. A photograph of children is not "public" unless the school has said so.
+- `filename` (string) — A name to show in the library.
+- `title` (string) — A short title for the library.
+- `alt` (string) — What the picture shows, for someone using a screen reader.
+- `confirm` (boolean) — First call without confirm. Present the returned action, target and effect, END THE TURN, and wait for a NEW explicit user message approving that exact preview. Only then set true for the same action/target. Initial requests and client/native tool-permission approvals do not count.
+
 ### `ask_org`
 
 Ask a question and get an answer drawn from a Phenomenal organization's own documents and knowledge, with citations. Use this before guessing at anything about how a particular school does things.