Liveblocks

Instructions

Implementation Reference

• src/server.ts:113-130 (handler)

  The handler function for the 'update-room' tool. It extracts parameters, calls the Liveblocks updateRoom method with the provided accesses and metadata, and wraps the result using callLiveblocksApi.

    async (
      { roomId, defaultAccesses, groupsAccesses, usersAccesses, metadata },
      extra
    ) => {
      return await callLiveblocksApi(
        getLiveblocks().updateRoom(
          roomId,
          {
            defaultAccesses: defaultAccesses as any,
            groupsAccesses: groupsAccesses as any,
            usersAccesses: usersAccesses as any,
            metadata,
          },
          { signal: extra.signal }
        )
      );
    }
  );

• src/server.ts:106-112 (schema)

  Input schema definition for the 'update-room' tool using Zod, referencing shared access schemas.

  {
    roomId: z.string(),
    defaultAccesses: DefaultAccesses,
    groupsAccesses: GroupsAccesses.optional(),
    usersAccesses: UsersAccesses.optional(),
    metadata: z.record(z.string(), z.union([z.string(), z.null()])).optional(),
  },

• src/server.ts:103-130 (registration)

  Registration of the 'update-room' tool on the MCP server instance.

  server.tool(
    "update-room",
    "Update a Liveblocks room",
    {
      roomId: z.string(),
      defaultAccesses: DefaultAccesses,
      groupsAccesses: GroupsAccesses.optional(),
      usersAccesses: UsersAccesses.optional(),
      metadata: z.record(z.string(), z.union([z.string(), z.null()])).optional(),
    },
    async (
      { roomId, defaultAccesses, groupsAccesses, usersAccesses, metadata },
      extra
    ) => {
      return await callLiveblocksApi(
        getLiveblocks().updateRoom(
          roomId,
          {
            defaultAccesses: defaultAccesses as any,
            groupsAccesses: groupsAccesses as any,
            usersAccesses: usersAccesses as any,
            metadata,
          },
          { signal: extra.signal }
        )
      );
    }
  );

• src/zod.ts:41-48 (schema)

  Shared Zod schema for defaultAccesses parameter used in 'update-room' tool.

  export const DefaultAccesses = z.array(z.string()).describe(
    `The default access permissions for the room. Permissions can be: 
          
          1. ["room:write"] // public
          2. ["room:read", "room:presence:write"] // read-only
          3. [] // private        
      `
  );

• src/utils.ts:3-37 (helper)

  Utility function used by the 'update-room' handler to call Liveblocks API and format the MCP tool response.

  export async function callLiveblocksApi(
    liveblocksPromise: Promise<any>
  ): Promise<CallToolResult> {
    try {
      const data = await liveblocksPromise;
  
      if (!data) {
        return {
          content: [{ type: "text", text: "Success. No data returned." }],
        };
      }
  
      return {
        content: [
          {
            type: "text",
            text: "Here is the data. If the user has no specific questions, return it in a JSON code block",
          },
          {
            type: "text",
            text: JSON.stringify(data, null, 2),
          },
        ],
      };
    } catch (err) {
      return {
        content: [
          {
            type: "text",
            text: "" + err,
          },
        ],
      };
    }
  }