@okostream/mcp 0.1.1 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ MCP server for managing OKO Stream webinars as an organizer.
 
 ## Quick Setup
 
-1. Create an API key in OKO: `/app/settings` -> API keys for MCP.
+1. Create an API key in OKO: `/app/mcp` -> access keys.
 2. Add the server to your MCP client config.
 
 Claude Desktop / Claude Code:
@@ -54,7 +54,7 @@ Every tool returns JSON text plus MCP `structuredContent`. List-like tools use b
 
 - `limit` defaults to 20-50 depending on the tool.
 - Cursor tools return both `hasMore`/`nextCursor` and `has_more`/`next_cursor`.
-- `oko_list_my_events`, `oko_get_analytics`, `oko_list_recent_chat`, `oko_list_participants`, and `oko_list_leads` support pagination.
+- `oko_list_my_events`, `oko_get_analytics`, `oko_list_recent_chat`, `oko_list_participants`, `oko_list_leads`, `oko_list_workspace_access`, `oko_list_workspace_invites`, and `oko_list_telegram_posts` support pagination.
 - `oko_get_analytics` omits heavy `timeline`, baseline/final snapshots, and NMO participant rows by default. Request `includeTimeline`, `includeSnapshots`, or `includeNmoRows` only when needed.
 - Oversized responses are truncated with `truncated: true` and a `truncationMessage`.
 
@@ -89,39 +89,32 @@ Local config without npm publishing:
 
 All tools are prefixed with `oko_` for safe discovery next to other MCP servers.
 
-Read tools include:
-
-- `oko_whoami`
-- `oko_list_workspaces`
-- `oko_list_my_events`
-- `oko_get_event`
-- `oko_get_live_state`
-- `oko_get_analytics`
-- `oko_list_recent_chat`
-- `oko_list_participants`
-- `oko_list_leads`
-
-Write/control tools include:
-
-- `oko_create_webinar`
-- `oko_update_event`
-- `oko_configure_blocks`
-- `oko_upload_image`
-- `oko_delete_image`
-- `oko_set_block_visibility`
-- `oko_refresh_viewers`
-- `oko_start_session`
-- `oko_end_session`
-- `oko_send_chat_message`
-- `oko_delete_chat_message`
-- `oko_mute_user`
-- `oko_ban_user`
-- `oko_set_chat_settings`
-- `oko_launch_checkpoint`
-- `oko_close_checkpoint`
-- `oko_publish_telegram_post`
-- `oko_create_workspace_invite`
-- `oko_delete_event`
+Core discovery/read tools:
+
+- `oko_whoami`, `oko_list_workspaces`, `oko_list_my_events`, `oko_get_event`
+- `oko_get_live_state`, `oko_get_analytics`, `oko_list_recent_chat`, `oko_list_participants`, `oko_list_leads`
+
+Event/setup/media tools:
+
+- `oko_create_webinar`, `oko_update_event`, `oko_delete_event`
+- `oko_duplicate_event`, `oko_move_event`
+- `oko_configure_blocks`, `oko_configure_cards`
+- `oko_upload_image`, `oko_delete_image`
+
+Live/session/chat/NMO tools:
+
+- `oko_set_block_visibility`, `oko_refresh_viewers`
+- `oko_start_session`, `oko_end_session`, `oko_fix_orphan_session`, `oko_delete_session`
+- `oko_send_chat_message`, `oko_delete_chat_message`, `oko_mute_user`, `oko_unmute_user`, `oko_ban_user`, `oko_unban_user`, `oko_set_chat_settings`
+- `oko_launch_checkpoint`, `oko_close_checkpoint`
+- `oko_add_nmo_participant`, `oko_import_nmo_participants`, `oko_remove_nmo_participant`
+
+Workspace and Telegram tools:
+
+- `oko_create_workspace`, `oko_update_workspace`, `oko_delete_workspace`
+- `oko_list_workspace_access`, `oko_update_workspace_member`, `oko_remove_workspace_member`
+- `oko_create_workspace_invite`, `oko_list_workspace_invites`, `oko_revoke_workspace_invite`, `oko_claim_workspace_invite`
+- `oko_list_telegram_channels`, `oko_claim_telegram_channel`, `oko_list_telegram_posts`, `oko_cancel_telegram_post`, `oko_publish_telegram_post`
 
 Dangerous or external side-effect tools require `confirm: true`.
 
@@ -130,9 +123,12 @@ Dangerous or external side-effect tools require `confirm: true`.
 1. `oko_whoami` should return the organizer UID and granted scopes.
 2. `oko_list_my_events` should return only events visible to that UID.
 3. `oko_create_webinar` should create a test webinar and RTDB owner/workspace mirror.
-4. `oko_upload_image` should accept a local path or HTTPS image URL, upload `master.webp`, and let OKO generate variants.
-5. `oko_delete_image` should clear image fields and best-effort delete master/variants.
-6. `oko_get_analytics` should read an existing event with analytics sessions.
+4. `oko_configure_cards` should create/update `blocks.cards.items` and preserve card image fields by stable card id.
+5. `oko_upload_image` should accept a local path or HTTPS image URL, upload `master.webp`, and let OKO generate variants.
+6. `oko_start_session` -> `oko_fix_orphan_session` -> `oko_delete_session` should leave no active session pointers on a disposable test event.
+7. `oko_duplicate_event`, workspace tools, and `oko_move_event` should preserve Firestore access rules and RTDB owner/workspace mirrors.
+8. `oko_import_nmo_participants` should call CF24 and return per-row results; clean up test participants after import.
+9. `oko_get_analytics` should read an existing event with analytics sessions.
 
 CLI help:
 

package/dist/server.js

@@ -22,7 +22,7 @@ if (process.argv.includes("--help")) {
 }
 const server = new McpServer({
     name: "oko-mcp-server",
-    version: "0.1.1",
+    version: "0.2.0",
 });
 registerTools(server);
 const transport = new StdioServerTransport();