USCardForum MCP Server

Instructions

Implementation Reference

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

  The MCP tool handler implementation for 'get_current_session'. It is decorated with @mcp.tool() and delegates to the shared client's get_current_session method to retrieve the current authentication session.
  @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 BaseModel defining the output schema for the get_current_session tool. Includes fields for current_user (optional) and is_authenticated boolean, with a classmethod for parsing from API responses.
  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/client.py:482-488 (helper)

  Helper method in DiscourseClient that implements the core session retrieval logic by delegating to the AuthAPI submodule.
  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_tools/__init__.py:52-58 (registration)

  Re-export of the get_current_session tool from the auth module, making it available at the server_tools package level for the MCP server entrypoint.
  from .auth import ( login, get_current_session, get_notifications, bookmark_post, subscribe_topic, )
• src/uscardforum/server.py:15-25 (registration)

  Import of get_current_session into the MCP server entrypoint module, where it is exposed in __all__ for automatic tool registration in main().
  from uscardforum.server_tools import ( analyze_user, bookmark_post, compare_cards, find_data_points, get_all_topic_posts, get_categories, get_current_session, get_hot_topics, get_new_topics, get_notifications,