get_current_session

Instructions

Get information about the current session.

Returns a Session object with:
- is_authenticated: Whether logged in
- current_user: CurrentUser object with user info (if authenticated)

Use to verify authentication status.

Implementation Reference

• src/uscardforum/server_tools/auth.py:64-76 (handler)

  MCP tool handler for get_current_session. Registers the tool and delegates to the shared client instance.

  @mcp.tool()
  def get_current_session() -> Session:
      """
      Get information about the current session.
  
      Returns a Session object with:
      - is_authenticated: Whether logged in
      - current_user: CurrentUser object with user info (if authenticated)
  
      Use to verify authentication status.
      """
      return get_client().get_current_session()

• src/uscardforum/models/auth.py:46-64 (schema)

  Pydantic model for Session return type, including from_api_response factory method.

  class Session(BaseModel):
      """Current session information."""
  
      current_user: CurrentUser | None = Field(None, description="Logged-in user")
      is_authenticated: bool = Field(False, description="Whether authenticated")
  
      class Config:
          extra = "ignore"
  
      @classmethod
      def from_api_response(cls, data: dict[str, Any]) -> "Session":
          """Parse from raw API response."""
          user_data = data.get("current_user") or data.get("user")
          current_user = CurrentUser(**user_data) if user_data else None
          return cls(
              current_user=current_user,
              is_authenticated=current_user is not None,
          )

• src/uscardforum/api/auth.py:97-111 (helper)

  Core API implementation that fetches session from /session/current.json endpoint and handles unauthenticated case.

  def get_current_session(self) -> Session:
      """Get current session info.
  
      Returns:
          Session data including user info (unauthenticated if no session)
      """
      try:
          payload = self._get("/session/current.json")
          return Session.from_api_response(payload)
      except requests.exceptions.HTTPError as e:
          # 404 means no session - return unauthenticated session
          if e.response is not None and e.response.status_code == 404:
              return Session(is_authenticated=False, current_user=None)
          raise

• src/uscardforum/client.py:482-488 (helper)

  Client wrapper that delegates to AuthAPI.get_current_session()

  def get_current_session(self) -> Session:
      """Get current session info.
  
      Returns:
          Session data including user info
      """
      return self._auth.get_current_session()

• src/uscardforum/server_core.py:136-168 (helper)

  Shared singleton client factory used by all tools, with optional auto-login.

  def get_client() -> DiscourseClient:
      """Get or create the Discourse client instance."""
      global _client, _login_attempted
  
      if _client is None:
          base_url = os.environ.get("USCARDFORUM_URL", "https://www.uscardforum.com")
          timeout = float(os.environ.get("USCARDFORUM_TIMEOUT", "15.0"))
          _client = DiscourseClient(base_url=base_url, timeout_seconds=timeout)
  
          # Auto-login if credentials are provided
          if not _login_attempted:
              _login_attempted = True
              username = os.environ.get("NITAN_USERNAME")
              password = os.environ.get("NITAN_PASSWORD")
  
              if username and password:
                  try:
                      result = _client.login(username, password)
                      if result.success:
                          print(f"[uscardforum] Auto-login successful as '{result.username}'")
                      elif result.requires_2fa:
                          print(
                              "[uscardforum] Auto-login failed: 2FA required. Use login() tool with second_factor_token."
                          )
                      else:
                          print(
                              f"[uscardforum] Auto-login failed: {result.error or 'Unknown error'}"
                          )
                  except Exception as e:  # pragma: no cover - logging side effect
                      print(f"[uscardforum] Auto-login error: {e}")
  
      return _client