get-user-room-subscription-settings

Retrieve user subscription settings for Liveblocks rooms to manage access and permissions.

Instructions

Get a user's room subscription settings

Input Schema

TableJSON Schema

Name	Required	Description	Default
`userId`	Yes

Implementation Reference

src/server.ts:640-654 (registration)

Registration of the MCP tool 'get-user-room-subscription-settings' using server.tool, specifying the name, description, Zod input schema, and inline async handler function that calls the Liveblocks API.

server.tool(
  "get-user-room-subscription-settings",
  `Get a user's room subscription settings`,
  {
    userId: z.string(),
  },
  async ({ userId }, extra) => {
    return await callLiveblocksApi(
      getLiveblocks().getUserRoomSubscriptionSettings(
        { userId },
        { signal: extra.signal }
      )
    );
  }
);

src/server.ts:646-653 (handler)
Inline handler function implementing the tool logic: calls getLiveblocks().getUserRoomSubscriptionSettings with the userId and formats the response using callLiveblocksApi.
```
async ({ userId }, extra) => {
  return await callLiveblocksApi(
    getLiveblocks().getUserRoomSubscriptionSettings(
      { userId },
      { signal: extra.signal }
    )
  );
}
```
src/server.ts:643-645 (schema)
Zod schema for tool input parameters: requires a 'userId' string.
```
{
  userId: z.string(),
},
```

src/server.ts:21-28 (helper)

Helper function that lazily creates and returns a Liveblocks client instance using the LIVEBLOCKS_SECRET_KEY environment variable.

function getLiveblocks() {
  if (!client) {
    client = new Liveblocks({
      secret: process.env.LIVEBLOCKS_SECRET_KEY as string,
    });
  }
  return client;
}

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

Helper utility that executes a Liveblocks API promise, handles success by returning formatted JSON in MCP content or error message, used by all tools.

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,
        },
      ],
    };
  }
}

Liveblocks