USCardForum MCP Server

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 @mcp.tool()-decorated handler function implementing the core logic of the get_user_actions tool. Includes input schema definitions via Annotated and Pydantic Field, docstring, and delegation to the underlying client API.

  @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 return type (list[UserAction]) of the get_user_actions tool, providing output schema validation and structure.

  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)

  Import statement in server_tools/__init__.py that registers the get_user_actions tool by importing it into the package namespace, making it available for MCP auto-registration upon import.

  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:16-45 (registration)

  Import of all tools including get_user_actions in the main server.py entrypoint file, ensuring the tool is registered in the MCP server context.

      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,
  )