@okostream/mcp 0.18.3 → 0.19.0

package/README.md

@@ -109,7 +109,9 @@ A new page is a draft: viewers of its public URL see "not published".
   `SCOPE_REQUIRED` and need a new key. A page in a shared workspace is paid from
   the workspace owner's wallet: its balance is told, in the previews and
   refusals, to whoever may spend from it; its grants and ledger are the owner's
-  to read.
+  to read. `oko_workspace_wallet` reads just that balance for one workspace, as a
+  single number (the payer, or a member who may spend from the payer's wallet;
+  same scope `wallet:read`); an unreadable balance is an error, never zero.
 - **Payment and terms are web-only.** Plans and lumens are bought, and terms
   accepted, only in the OKO web cabinet, and no MCP tool collects a password,
   card or bank details, or agreement to terms on anyone's behalf.
@@ -144,6 +146,13 @@ Refusals are explicit and never require guessing:
   workspace owner does not hold another shared workspace, another member, or
   the capability at all. A refused invitation stays valid. Plans are bought only
   in the OKO cabinet, never through MCP.
+- `CONTROL_ROOM_REQUIRED` — `oko_control_poll` was asked to launch a poll for
+  everyone or to reset its count, which use the live control room of the show
+  (a paid option of a published page, bought in the analytics screen, never
+  through MCP). Showing the results, closing, reopening and hiding need no
+  control room. Nothing is changed by the refusal.
+- `WALLET_VIEW_FORBIDDEN` — `oko_workspace_wallet` tells the balance only to the
+  payer of the workspace and to members who may spend from it.
 - `WORKSPACE_INACTIVE` — `oko_publish_event` in a shared workspace the plan does
   not hold open (only a new publication is closed): Core — shared workspaces are
   not included (Pro); Pro — one active workspace (the owner's choice, or Max); no
@@ -170,17 +179,25 @@ always works. The result's `sourceVia` says who fetched the image.
 ## Capabilities
 
 - Create, duplicate, move, restore, and delete webinars.
-- Configure video, forms, calls to action, cards, banners, and images. On an
-  already published page, turning on a banner, CTA, cards or forms costs 10
-  lumens each for that show: the tool answers with the quote first and writes
-  only after `confirm=true`; unpublishing later does not return these top-ups.
+- Configure video, forms, polls, calls to action, cards, banners, and images.
+  On an already published page, turning on a banner, CTA, cards, forms or polls
+  costs 10 lumens each for that show: the tool answers with the quote first and
+  writes only after `confirm=true`; unpublishing later does not return these
+  top-ups.
   The live control room is a paid option of a published page (50 lumens, Pro
   and above) bought in the analytics screen, not through MCP.
 - Operate live audience controls, chat, moderation, and analytics sessions.
-- Read analytics, session reports, geography, engagement, and form submissions.
+- Run polls: build them, bind them to buttons, close and reopen voting, show or
+  hide the results to viewers, launch one for everyone or reset its count (the
+  last two with the live control room), and read the live count and the
+  per-session results (`oko_control_poll`, `oko_get_live_state`,
+  `oko_get_session_report`).
+- Read analytics, session reports, geography, engagement, form submissions and
+  poll results.
 - Manage workspaces, invitations, notifications, and Telegram publishing
   (5 lumens per post, shown in the confirmation preview).
-- Read your own plan, lumen balance and ledger (`oko_wallet`).
+- Read your own plan, lumen balance and ledger (`oko_wallet`), and the balance of
+  the wallet that pays for a workspace (`oko_workspace_wallet`).
 
 OKO MCP acts as the organizer represented by the selected access key. It does
 not inherit platform-owner privileges. Keys are scoped and revocable, and