edit-thread-metadata

Modify or remove metadata for threads in Liveblocks collaborative applications to organize and manage conversation data.

Instructions

Edit a Liveblocks thread's metadata. null can be used to remove a key.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`roomId`	Yes
`threadId`	Yes
`data`	Yes

Implementation Reference

src/server.ts:313-336 (registration)

Registration of the 'edit-thread-metadata' MCP tool, including inline input schema (Zod) and handler function that proxies to Liveblocks API via callLiveblocksApi.

server.tool(
  "edit-thread-metadata",
  `Edit a Liveblocks thread's metadata. \`null\` can be used to remove a key.`,
  {
    roomId: z.string(),
    threadId: z.string(),
    data: z.object({
      metadata: z.record(
        z.string(),
        z.union([z.string(), z.boolean(), z.number(), z.null()])
      ),
      userId: z.string(),
      updatedAt: z.date().optional(),
    }),
  },
  async ({ roomId, threadId, data }, extra) => {
    return await callLiveblocksApi(
      getLiveblocks().editThreadMetadata(
        { roomId, threadId, data },
        { signal: extra.signal }
      )
    );
  }
);

src/server.ts:328-335 (handler)

The handler function executes the tool logic by calling the Liveblocks editThreadMetadata API and formatting the response.

async ({ roomId, threadId, data }, extra) => {
  return await callLiveblocksApi(
    getLiveblocks().editThreadMetadata(
      { roomId, threadId, data },
      { signal: extra.signal }
    )
  );
}

src/server.ts:317-327 (schema)

Inline Zod schema defining the input parameters for the edit-thread-metadata tool.

  roomId: z.string(),
  threadId: z.string(),
  data: z.object({
    metadata: z.record(
      z.string(),
      z.union([z.string(), z.boolean(), z.number(), z.null()])
    ),
    userId: z.string(),
    updatedAt: z.date().optional(),
  }),
},

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

Shared helper function used by the handler to execute Liveblocks API calls and format MCP tool responses.

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