JoinCloud

Instructions

Implementation Reference

• src/server/actions/room.ts:43-72 (handler)

  The handler implementation for creating a room.

  handler: async (params, ctx) => {
    const roomId = crypto.randomUUID();
    const name = (params.name || roomId).toLowerCase();
  
    if (RESERVED.includes(name.toLowerCase())) {
      throw new Error(`Room name "${name}" is reserved.`);
    }
  
    const existing = await ctx.store.getRoomsByName(name);
    if (existing.length > 0) {
      if (!params.password && existing.some((r) => r.hasPassword)) {
        throw new Error(`Password-protected room "${name}" already exists. You must provide a password.`);
      }
    }
  
    try {
      await ctx.store.createRoom(roomId, name, params.password);
    } catch (e: any) {
      if (e?.code === "23505") {
        throw new Error(`Room "${name}" already exists${params.password ? " with this password" : ""}.`);
      }
      throw e;
    }
  
    return {
      text: `Room created: ${roomId}${params.password ? " (password protected)" : ""}`,
      contextId: roomId,
      data: { roomId, name, passwordProtected: !!params.password },
    };
  },

• src/server/protocols/mcp/adapters.ts:5-19 (registration)

  MCP registration of the createRoom tool.

  server.mcp("room.create", {
    toolName: "createRoom",
    description: "Create a new collaboration room. Returns the room ID for joining.",
    params: z.object({
      name: z.string().optional().describe("Room name"),
      password: z.string().optional().describe("Optional password to protect the room"),
    }),
    annotations: {
      title: "Create Room",
      readOnlyHint: false,
      destructiveHint: false,
      idempotentHint: false,
      openWorldHint: false,
    },
  });