@okostream/mcp 0.18.2 → 0.19.0

package/README.md

@@ -95,14 +95,23 @@ A new page is a draft: viewers of its public URL see "not published".
   `oko_start_session`, `oko_extend_session` and `oko_publish_telegram_post`
   state the charge (or the refund) when called without `confirm`, name the
   wallet that pays, and take nothing until the organizer confirms. The amount in
-  the preview is the amount charged; the public price list is at
+  the preview of a charge is the amount charged; the preview of a withdrawal
+  (`oko_unpublish_event`, the trash) says "up to", because part of the refund
+  may be forfeited and only the answer after confirmation gives the exact
+  figures. The public price list is at
   [okostream.app/pricing](https://okostream.app/pricing) and is not copied here.
-- **`oko_wallet` reads the wallet.** It returns the lumen balance, the grants and
-  the ledger of the organizer behind the key (scope `wallet:read`, included in
-  the `operator` and `full` presets, not in `readOnly`). Keys created before that scope existed get `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.
+- **`oko_wallet` reads the plan and the wallet.** It returns the plan (tier,
+  status, period end, source), the lumen balance, the grants and the ledger of
+  the organizer behind the key, with the link to the cabinet's Billing page
+  (scope `wallet:read`, included in the `operator` and `full` presets, not in
+  `readOnly`). It cannot buy, change or cancel anything: a plan or lumens are
+  bought only in that cabinet. Keys created before that scope existed get
+  `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. `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.
@@ -137,8 +146,17 @@ 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.
-- `WORKSPACE_INACTIVE` — `oko_publish_event` in a shared workspace the plan no
-  longer publishes into (Pro: only the workspace its owner chose as active).
+- `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
+  live subscription — renew.
 
 **One install path.** Every supported client — Claude Code, Codex, and any
 MCP client that takes a command with arguments and env — runs the package
@@ -161,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 the lumen balance and ledger of your own wallet (`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