N Lobby MCP Server

Instructions

Implementation Reference

• src/server.ts:246-260 (registration)

  Registration of the 'get_schedule' tool in the ListToolsRequestSchema handler, including its description and input schema definition.

  {
    name: "get_schedule",
    description:
      "Get school schedule for a specific date (backward compatibility)",
    inputSchema: {
      type: "object",
      properties: {
        date: {
          type: "string",
          description:
            "Date in YYYY-MM-DD format (optional, defaults to today)",
        },
      },
    },
  },

• src/server.ts:713-734 (handler)

  Handler implementation for the 'get_schedule' tool that parses input arguments, calls the API method this.api.getScheduleByDate(date), and returns the schedule data as JSON text or an error message.

  case "get_schedule":
    try {
      const { date } = args as { date?: string };
      const schedule = await this.api.getScheduleByDate(date);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(schedule, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : "Unknown error"}\n\nTo authenticate:\n1. Login to N Lobby in your browser\n2. Open Developer Tools (F12)\n3. Go to Application/Storage tab\n4. Copy cookies and use the set_cookies tool\n5. Use health_check to verify connection`,
          },
        ],
      };
    }

• src/server.ts:253-259 (schema)

  Input schema definition for the 'get_schedule' tool, specifying the optional 'date' parameter.

      date: {
        type: "string",
        description:
          "Date in YYYY-MM-DD format (optional, defaults to today)",
      },
    },
  },