get_current_session

Retrieve current session details to verify authentication status and access user information for USCardForum interactions.

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

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

USCardForum MCP Server