# Whereby MCP MCP > Whereby MCP lets you manage embedded video infrastructure entirely through conversation. You can instantly provision transient meeting rooms, update custom branding themes, monitor active sessions, retrieve recording links, and clean up old data—all without touching a dashboard. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** video-meetings, browser-based, embeddable-ui, real-time-communication, meeting-rooms, api-integration ## Description Managing video calls used to mean logging into a separate portal and manually clicking through multiple dashboards just to get started or find an old file. Now, you connect your Whereby account to any AI agent and treat your entire video communication setup as a conversational tool. Your agent can provision new meeting rooms with specific expiration dates or lock them down for security. Need to change the company logo on every room? Just ask it to update the theme. If you need to audit past sessions, the agent pulls all cloud recordings and gives you direct download links, letting you list everything stored in your account. Because every tool call is tracked through Vinkius AI Analytics, you always know exactly what data flowed, which is critical when managing sensitive meeting details or deleting old records. This isn't just a wrapper for buttons; it’s turning complex video operations into simple commands. ## Tools ### create_meeting_room Creates a new video room that expires on a specific date and time, setting the access mode (normal or group). ### delete_cloud_recording Permanently removes a selected cloud recording file from your account. This action is irreversible. ### delete_meeting_room Immediately terminates and deletes an entire video meeting room, stopping any active calls in that space. ### get_meeting_details Pulls the join URL and expiration date for a specific existing video meeting. ### get_recording_details Retrieves download links and metadata necessary to access a specific stored cloud recording. ### get_room_theme Reads the current visual theme settings (like colors or logo) for a specified meeting room name. ### list_active_meetings Generates a list of all video rooms that are currently running or waiting to start. ### list_cloud_recordings Lists every cloud recording file saved in the Whereby account, providing an overview of your storage. ### reset_room_theme Forces a specific meeting room's visual theme back to the original default branding settings. ### update_room_theme Changes the primary branded color for an existing meeting room using a custom hex code. ## Prompt Examples **Prompt:** ``` Create a new 'group' meeting room that expires in 2 hours. ``` **Response:** ``` I've created a new group meeting room. It is set to expire on 2026-04-01 at 12:00 PM UTC. Your join URL is: https://whereby.com/room-abc-123. Would you like me to lock the room as well? ``` **Prompt:** ``` List all my past cloud recordings. ``` **Response:** ``` I found 3 recordings: 1. 'Project Sync' (2026-03-25), 2. 'Client Demo' (2026-03-28), and 3. 'Strategy Session' (2026-03-30). Would you like the download link for any of these? ``` **Prompt:** ``` Update the 'Support-101' room theme to use hex color #00ff00. ``` **Response:** ``` Successfully updated the theme for room 'Support-101'. The primary branding color is now set to #00ff00 (Green). You can view the changes in your embedded iframe immediately. ``` ## Capabilities ### Provisioning Meeting Rooms Creates new, temporary video rooms with defined expiration dates and access modes. ### Managing Room Branding Updates the visual theme and primary color of specific meeting rooms to match your corporate branding. ### Retrieving Meeting Status Gets full details on a specific video session, including its join URL and current status. ### Listing and Downloading Recordings Provides an inventory of all stored cloud recordings and generates direct download links for the files. ### Monitoring Live Sessions Lists all meeting rooms that are currently active or pending, giving you their unique identifiers for automation. ## Use Cases ### Onboarding a New Client A support engineer needs to set up an immediate troubleshooting session. Instead of logging into Whereby and creating a room manually, they tell their agent to 'Create a group meeting room for the client that expires in 4 hours.' The agent executes `create_meeting_room` instantly and gives the join URL. ### Post-Webinar Followup A marketing manager needs an archive of all recorded sessions from a week's worth of webinars. They ask the agent to 'List all cloud recordings.' The agent runs `list_cloud_recordings` and provides links to every file, allowing them to download them for follow-up material. ### Developer Testing A product developer is building a new feature and needs to ensure the UI looks right. They ask their agent to 'Check the branding on the staging room.' The agent uses `get_room_theme` to retrieve the current color codes, letting them test the integration before deployment. ### Resource Cleanup An operations team member is concerned about storage limits. They ask the agent to 'Find and delete all meeting rooms that are past their expiration date.' The agent can use `list_active_meetings` first, then run `delete_meeting_room` on old ones. ## Benefits - Instant Room Provisioning: Stop waiting for admin approval. You can use the agent to `create_meeting_room` instantly, setting specific expiration dates or group modes in seconds. - Branding Control: Don't just use generic calls. Use `update_room_theme` to apply custom hex colors and logos, making your meetings look exactly like they belong on your site. - Audit Trail & Retrieval: Need proof of a conversation? You can run `list_cloud_recordings` and get the download links using `get_recording_details` for every past session. - Security Management: Automatically clean up junk resources. Use `delete_meeting_room` or `delete_cloud_recording` to manage quotas without manually navigating deletion menus. - Full Visibility: The system knows exactly what happened, because Vinkius AI Analytics tracks the data flow from every call, so nothing gets lost in the manual process. ## How It Works The bottom line is, you talk to your agent like talking to an employee who already has full access to your video infrastructure. 1. Subscribe to this MCP and provide your Whereby API key. 2. Tell your AI agent what you need—for example, 'Create a group meeting room that expires in four hours.' 3. The agent executes the request via the secure Vinkius platform and responds with the outcome or required data. ## Frequently Asked Questions **How do I create a new meeting room using create_meeting_room?** You tell your agent to 'Create a normal group meeting room expiring in 6 hours.' The tool handles the date calculation and provisions the transient room immediately. **What is the best way to list my recordings? Should I use list_cloud_recordings or get_recording_details?** Use `list_cloud_recordings` first. That tool gives you a complete overview of everything stored in your account, and then you can ask for specific links using `get_recording_details`. **Can I change the room color without deleting the meeting?** Yes. You use `update_room_theme`, providing the room name and the desired hex code. This changes only the visual branding, not the operational state of the room. **If I want to delete a recording, should I use list_cloud_recordings first?** Yes, you should always confirm what you're deleting. Run `list_cloud_recordings` to get an inventory, then tell the agent which specific record ID to pass to `delete_cloud_recording`. **If I use `delete_meeting_room`, does it just delete the room, or does it also terminate active sessions?** It immediately deletes both. The tool terminates any active session tied to that meeting room's unique UUID. You can trust this action cleans up all associated resources. **How do I use `list_active_meetings` for automated workflows, and what does it return?** It returns a list of currently active or pending rooms. Crucially, you get their unique UUIDs, which lets your agent monitor status without needing the room name. **I used `update_room_theme` and need to revert it; is there a simple way to reset the branding?** Yes, run `reset_room_theme`. This instantly reverts any modified visual settings back to Whereby's default corporate branding colors. **What precautions should I take before running the irreversible `delete_cloud_recording` tool?** You must confirm the recording details first. Since this action is permanent, always use `get_recording_details` to verify download links and metadata before deletion.