@okostream/mcp 0.12.1 → 0.12.3

package/README.md

@@ -7,7 +7,7 @@ analytics, and integrations around a video player supplied by the organizer.
 ## Before You Connect
 
 Webinar data and actions require an active OKO organizer account. Organizer
-access is currently provided by invitation rather than public self-service
+an active organizer account is required before an API key can be created
 signup.
 
 - Already invited: [sign in or register](https://okostream.app/auth?redirect=/app/mcp).
@@ -21,6 +21,18 @@ Node.js 20.18.1 or newer is required.
 
 ## Install
 
+The package ships as one self-contained file (about 4 MB, no dependencies to
+install). Before wiring it into a client, warm it up once in a terminal and
+wait for the `OKO MCP Server` banner:
+
+```bash
+npx -y @okostream/mcp@latest --help
+```
+
+This keeps the first client start under the 30-second MCP startup timeout;
+an interrupted first download would otherwise leave a broken copy in the npx
+cache and the client would report `Connection closed`.
+
 ### Claude Desktop and JSON-based clients
 
 ```json
@@ -63,6 +75,32 @@ After the connection is active:
 
 > Use OKO to show who I am and list my latest webinars.
 
+## Updating
+
+With `npx -y @okostream/mcp@latest`, restarting the client installs the newest
+published version. The server reports the latest version during the key
+exchange: `oko_whoami` and `oko_connection_status` return `update`, and the
+first results of a session carry an `UPDATE AVAILABLE` block while the client
+is behind, with the exact update step. Global installs update with
+`npm install -g @okostream/mcp@latest`; Claude Desktop users reinstall the
+`.mcpb` bundle from the install center.
+
+## When a tool refuses
+
+Refusals are explicit and never require guessing:
+
+- `SCOPE_REQUIRED` — the API key lacks a scope; the result names the key
+  presets that include it and a workaround when one exists.
+- `PLATFORM_REJECTED_WRITE` — OKO's security rules refused the write. Retrying
+  or rephrasing does not help; the result carries a ready-made report for the
+  OKO team.
+- `PLATFORM_REJECTED_READ` — no access to that resource, or it does not exist.
+
+Image URLs are resolved locally. On a machine where a VPN or proxy intercepts
+DNS, public hosts resolve to fake addresses (`198.18.x.x`); such uploads still
+work, and the result says so. Uploading a file from disk (`OKO_IMAGE_ROOTS`)
+always works.
+
 ## Capabilities
 
 - Create, duplicate, move, restore, and delete webinars.