get_user_actions

Instructions

Fetch a user's activity feed with optional filtering.

Args:
    username: The user's handle
    filter: Action type filter (optional). Common values:
        - 1: Likes given
        - 2: Likes received
        - 4: Topics created
        - 5: Replies posted
        - 6: Posts (all)
        - 7: Mentions
    offset: Pagination offset (0, 30, 60, ...)

Returns a list of UserAction objects showing what the user has done.

Use this for detailed activity analysis beyond just replies.
For most cases, get_user_replies or get_user_topics are simpler.

Implementation Reference

• src/uscardforum/server_tools/users.py:121-158 (handler)

  The primary MCP tool handler for 'get_user_actions'. Decorated with @mcp.tool(), defines input schema via Annotated Fields, includes comprehensive docstring, and implements logic by calling the underlying API client.

  @mcp.tool()
  def get_user_actions(
      username: Annotated[
          str,
          Field(description="The user's handle"),
      ],
      filter: Annotated[
          int | None,
          Field(
              default=None,
              description="Action type filter: 1=likes given, 2=likes received, 4=topics created, 5=replies posted, 6=all posts, 7=mentions",
          ),
      ] = None,
      offset: Annotated[
          int | None,
          Field(default=None, description="Pagination offset (0, 30, 60, ...)"),
      ] = None,
  ) -> list[UserAction]:
      """
      Fetch a user's activity feed with optional filtering.
  
      Args:
          username: The user's handle
          filter: Action type filter (optional). Common values:
              - 1: Likes given
              - 2: Likes received
              - 4: Topics created
              - 5: Replies posted
              - 6: Posts (all)
              - 7: Mentions
          offset: Pagination offset (0, 30, 60, ...)
  
      Returns a list of UserAction objects showing what the user has done.
  
      Use this for detailed activity analysis beyond just replies.
      For most cases, get_user_replies or get_user_topics are simpler.
      """
      return get_client().get_user_actions(username, filter=filter, offset=offset)

• src/uscardforum/models/users.py:11-25 (schema)

  Pydantic BaseModel defining the UserAction type, which is the output type for the tool (list[UserAction]). Specifies fields and descriptions for user activity data.

  class UserAction(BaseModel):
      """A user activity entry (reply, like, etc.)."""
  
      action_type: int | None = Field(None, description="Type of action")
      topic_id: int | None = Field(None, description="Related topic ID")
      post_number: int | None = Field(None, description="Related post number")
      title: str | None = Field(None, description="Topic title")
      excerpt: str | None = Field(None, description="Content preview")
      created_at: datetime | None = Field(None, description="When action occurred")
      username: str | None = Field(None, description="Username who performed action")
      acting_username: str | None = Field(None, description="Acting user")
  
      class Config:
          extra = "ignore"

• src/uscardforum/server_tools/__init__.py:37-47 (registration)

  Package-level import and re-export of the get_user_actions tool from the users submodule, grouping it with other user-related MCP tools.

  from .users import (
      get_user_summary,
      get_user_topics,
      get_user_replies,
      get_user_actions,
      get_user_badges,
      get_user_following,
      get_user_followers,
      get_user_reactions,
      list_users_with_badge,
  )

• src/uscardforum/server.py:15-45 (registration)

  Imports all MCP tools including get_user_actions into the main FastMCP server entrypoint, making them available for automatic registration via decorators.

  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,
      get_top_topics,
      get_topic_info,
      get_topic_posts,
      get_user_actions,
      get_user_badges,
      get_user_followers,
      get_user_following,
      get_user_reactions,
      get_user_replies,
      get_user_summary,
      get_user_topics,
      list_users_with_badge,
      login,
      research_topic,
      resource_categories,
      resource_hot_topics,
      resource_new_topics,
      search_forum,
      subscribe_topic,
  )