USCardForum MCP Server

Instructions

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