N Lobby MCP Server

Instructions

Implementation Reference

• src/server.ts:984-994 (handler)

  The handler function for the 'verify_authentication' tool. It retrieves the authentication status from the API and appends recommendations generated by getAuthenticationRecommendations().

  case "verify_authentication": {
    const authStatus = this.api.getCookieStatus();
    return {
      content: [
        {
          type: "text",
          text: `[INFO] Authentication Verification Report\n\n${authStatus}\n\n[LOG] Recommendations:\n${this.getAuthenticationRecommendations()}`,
        },
      ],
    };
  }

• src/server.ts:399-407 (registration)

  Registration of the 'verify_authentication' tool in the ListToolsRequestSchema handler, including its name, description, and empty input schema.

  {
    name: "verify_authentication",
    description:
      "Verify authentication status and cookie synchronization across all clients",
    inputSchema: {
      type: "object",
      properties: {},
    },
  },

• src/server.ts:1174-1232 (helper)

  Helper method called by the tool handler to generate specific recommendations based on the current authentication status.

  private getAuthenticationRecommendations(): string {
    const authStatus = this.api.getCookieStatus();
    const recommendations = [];
  
    // Check if no authentication is present
    if (
      authStatus.includes("[ERROR] no cookies") &&
      authStatus.includes("[ERROR] not authenticated")
    ) {
      recommendations.push(
        "1. Run interactive_login to authenticate with N Lobby",
      );
      recommendations.push(
        "2. Make sure to complete the login process in the browser window",
      );
      recommendations.push(
        '3. Wait for the "Login successful" message before proceeding',
      );
    }
  
    // Check if authentication is partial
    else if (authStatus.includes("[ERROR] not synchronized")) {
      recommendations.push("1. Cookie synchronization issue detected");
      recommendations.push(
        "2. Try running interactive_login again to refresh all cookies",
      );
      recommendations.push(
        "3. Check if any network issues are preventing proper cookie setting",
      );
    }
  
    // Check if authentication is complete but endpoints are failing
    else if (
      authStatus.includes("[SUCCESS] authenticated") &&
      authStatus.includes("[SUCCESS] synchronized")
    ) {
      recommendations.push("1. Authentication appears to be working correctly");
      recommendations.push(
        "2. If endpoints are still failing, the issue may be server-side",
      );
      recommendations.push(
        "3. Try running health_check to verify connectivity",
      );
      recommendations.push("4. Check if N Lobby server is experiencing issues");
    }
  
    // Default recommendations
    else {
      recommendations.push(
        "1. Check the authentication status above for specific issues",
      );
      recommendations.push(
        "2. Run health_check to verify overall system health",
      );
      recommendations.push("3. Try get_news to test data retrieval");
    }
  
    return recommendations.join("\n");
  }