JoinCloud

Instructions

Implementation Reference

• src/server/actions/room.ts:189-207 (handler)

  Handler implementation for the listRooms tool (registered as room.list).

  server.method("room.list", {
    description: "List public rooms (default 20, max 100). Sorted alphabetically.",
    params: z.object({
      search: z.string().optional().describe("Wildcard search by room name"),
      limit: z.number().optional().describe("Number of rooms to return (default 20, max 100)"),
      offset: z.number().optional().describe("Skip N rooms (default 0)"),
    }),
    handler: async (params, ctx) => {
      const list = await ctx.store.listRooms({
        search: params.search,
        limit: params.limit,
        offset: params.offset,
      });
      return {
        text: JSON.stringify(list, null, 2),
        data: { rooms: list },
      };
    },
  });

• src/server/protocols/mcp/adapters.ts:74-89 (registration)

  MCP tool registration for listRooms.

  server.mcp("room.list", {
    toolName: "listRooms",
    description: "List public rooms on the server. Sorted alphabetically.",
    params: z.object({
      search: z.string().optional().describe("Wildcard search by room name"),
      limit: z.number().optional().describe("Number of rooms (default 20, max 100)"),
      offset: z.number().optional().describe("Skip N rooms (default 0)"),
    }),
    annotations: {
      title: "List Rooms",
      readOnlyHint: true,
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: false,
    },
  });