@okostream/mcp 0.18.3 → 0.20.0

package/README.md

@@ -9,7 +9,7 @@ analytics, and integrations around a video player supplied by the organizer.
 Webinar data and actions require an active OKO organizer account. An active
 organizer account is required before an API key can be created.
 
-- Already invited: [sign in or register](https://okostream.app/auth?redirect=/app/mcp).
+- Have an account: [sign in or register](https://okostream.app/auth?redirect=/app/mcp).
 - Already an organizer: create a scoped key in the
   [authenticated MCP install center](https://okostream.app/app/mcp).
 - No key yet: the server still starts in onboarding-only mode.
@@ -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,22 +179,30 @@ 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
 consequential actions require explicit confirmation.
 
 Local image access is disabled unless you explicitly select an allowed folder.
-The MCP package does not host video, create accounts, issue invitations, expose
+The MCP package does not host video, create accounts, issue platform invitations, expose
 arbitrary Firebase administration, or inherit platform-owner privileges.