# Liveblocks MCP for AI Agents AI Agent Connect > Liveblocks MCP lets you manage real-time collaboration infrastructure. Create rooms, authorize users, and inspect shared storage or threads directly from your AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_UpezS2s9jeUz8EcmyuM51kLyMnRyzY5qqCQseCek/ai-agent-connect - **Tags:** real-time-collaboration, room-management, user-presence, shared-state, multiplayer-infrastructure, api-auth ## Description Liveblocks MCP connects your account to any AI agent to manage real-time collaboration infrastructure through natural language. Instead of manually checking room states or hunting down specific user permissions, you can just ask your agent to do the work. You'll be able to spin up new collaborative spaces, verify who has access, and peek into the actual storage tree to see how your shared data is behaving. If you're managing complex shared documents or need to broadcast custom events to your connected clients, this Connector puts those controls directly into your workflow. It's a huge time saver for anyone building multiplayer experiences, and finding it in the Vinkius catalog makes it easy to plug into your existing setup. You can quickly clear out stale rooms, update properties on the fly, or resolve discussion threads without opening a browser tab. It turns your AI into a hands-on administrator for your real-time backend. You'll no longer have to worry about the tedious details of room lifecycle management or the headache of manual permission auditing. This setup gives you a direct line to your backend, letting you perform operations that used to require a series of clicks or specific API calls. Whether you're debugging a sync issue or just want to see who's currently active in a space, your agent handles the communication for you. It's about getting more done in your IDE without the constant context switching to a dashboard. ## Tools ### authorize_user Get an access token for a client to enter a room. This helps you manage permissions without manual backend updates. ### broadcast_event Send a JSON event to a specific room. Use this to push live updates to all your connected clients instantly. ### get_thread Pull out specific conversation histories for your agent to read. Use this to fetch a single discussion thread. ### create_room Spin up a new collaborative space for a project. This allows you to generate unique environments for different teams. ### create_thread Start a new discussion topic in a shared space. This includes the initial comment to get the conversation moving. ### delete_room Remove a space from your project. Use this to clean up stale data and keep your infrastructure tidy. ### get_room Retrieve the details of a specific space. Get all the metadata you need to see how a room is configured. ### get_storage Peek into the actual state of your shared data. This lets you inspect the room's Storage tree. ### get_ydoc See the current state of a shared document. This provides a JSON representation of the Yjs document. ### identify_user Verify who is trying to access your collaborative spaces. This provides an ID token for a client. ### initialize_storage Reset a shared state to a clean starting point. Use this to initialize or reinitialize the Storage. ### list_active_users See who is online and active in your collaborative spaces right now. This lists all currently connected clients. ### list_rooms Quickly find specific spaces based on metadata or access levels. This lists all rooms with filtering and pagination. ### list_threads Give your agent a full view of all ongoing discussions in a space. This lists all threads within a room. ### patch_storage Make precise updates to your shared state without overwriting everything. Apply JSON Patch operations to Storage. ### resolve_thread Mark a discussion as finished to keep conversations organized. Use this to resolve a specific thread. ### update_room Change room names, metadata, or settings on the fly. This allows you to update room properties without recreating the room. ### update_ydoc Send a binary Yjs update to a room for high performance. Use this to modify shared documents quickly. ## Prompt Examples **Prompt:** ``` Who is currently in the 'main-editor' room? ``` **Response:** ``` I've checked the active connections for 'main-editor'. Here are the users currently online: | User ID | Status | | :--- | :--- | | `alice_dev` | Connected | | `bob_designer` | Connected | | `charlie_pm` | Connected | Would you like me to fetch the permissions for any of these users? ``` **Prompt:** ``` Create a room called 'sprint-planning' and give it write access. ``` **Response:** ``` I've created the new room for you. **Room Details:** - **ID:** `sprint-planning` - **Access Level:** `room:write` - **Status:** Active I'm ready to authorize users for this space whenever you're ready. ``` **Prompt:** ``` Show me the current storage for the 'test-room'. ``` **Response:** ``` Here is the current storage tree for the `test-room`: ```json { "document_state": "initial_draft", "last_updated": "2026-07-10T15:54:19Z", "author_count": 3 } ``` Do you want me to apply a patch to this storage? ``` ## Capabilities ### Create and delete collaborative rooms Spin up new collaborative spaces or remove stale rooms with a single request. ### Authorize and identify users Manage room access permissions and verify user identities instantly. ### Inspect and patch storage state Peek into the room's storage tree and apply precise updates to shared data. ### Manage comment threads Query, create, and resolve discussion threads to keep team conversations organized. ### Monitor presence and broadcast events See who is currently online and push live JSON updates to your connected clients. ### Retrieve and update Yjs documents Get JSON representations of shared documents or send binary updates to the backend. ## Use Cases ### Debugging a stuck document A developer asks the agent to check the current storage tree and patch the state to fix a sync error. ### Onboarding a new user A product manager asks the agent to create a new room and authorize a specific user ID for the project. ### Monitoring active sessions A manager asks the agent to list all active users in the 'design-hub' room to see engagement. ### Cleaning up old data A DevOps engineer asks the agent to list all rooms with specific metadata and delete the stale ones. ## Benefits - Faster debugging: Get a clear view of your shared state and storage trees without having to write custom logging code or jump into a browser. This lets you see exactly what's happening in the backend so you can fix sync issues in seconds. - Quicker permissions: Manage user access and authorization rights on the fly to keep your collaborative spaces secure. You can verify who has access and issue new tokens without ever touching your backend configuration. - Easier room management: Create, update, or delete rooms instantly to keep your project organized and free of stale data. It makes it much easier to manage the lifecycle of different collaborative spaces as your app grows. - Better thread tracking: Keep team discussions organized by managing and resolving comment threads through your agent. You can pull specific conversation histories into your chat to keep project communication in one place. - Real-time monitoring: See who is online and active in your collaborative spaces right now to keep everyone in the loop. Use your agent to push live updates to your connected clients and broadcast custom events without extra overhead. ## How It Works The bottom line is it turns your AI client into a direct command line for your Liveblocks backend. 1. Subscribe to this Connector and provide your Liveblocks Secret Key. 2. Connect your preferred AI client like Claude or Cursor. 3. Ask your agent to perform actions like listing rooms or checking user presence. ## Frequently Asked Questions **Can I use Liveblocks MCP to manage my multiplayer rooms?** Yes, you can create, update, and delete rooms using natural language. This lets you manage your collaborative spaces without leaving your agent's chat interface. **How does Liveblocks MCP handle user permissions?** It lets your agent authorize users and identify them to manage access to specific rooms. You can grant or verify permissions on the fly. **Can my AI agent see the shared state of my documents?** Yes, it can retrieve the storage tree and Yjs document representations. This allows your agent to understand the current state of shared data. **Is Liveblocks MCP good for debugging real-time sync issues?** It's excellent for this because you can inspect storage and broadcast events instantly. It gives you a direct look at what the backend is doing. **Can I use this to manage comment threads?** Yes, you can list, create, and resolve threads to keep discussions organized. It's a great way to manage team communication within your rooms. **Does Liveblocks MCP work with my existing Liveblocks account?** Yes, you just need to provide your Secret Key to connect it to your agent. It will then have access to your existing rooms and infrastructure. **How can I filter rooms by specific metadata using the AI?** You can ask the agent to use the `list_rooms` tool and provide a JSON string in the metadata parameter. For example, ask to 'List rooms where the project metadata is alpha'. **Can I generate a temporary access token for a user to join a room?** Yes. Use the `authorize_user` tool. Provide the Room ID and User ID, and the agent will return a token that grants access to that specific room. **Is it possible to permanently delete a room and its data?** Yes, the `delete_room` tool allows you to permanently remove a room and all associated storage, comments, and metadata. Use this with caution as it is irreversible.