USCardForum MCP Server

Instructions

Fetch the latest/newest topics from USCardForum.

Returns recently created topics sorted by creation time (newest first).
These may have fewer replies but contain fresh information.

Use this to:
- Find newly posted deals or offers
- See fresh questions from the community
- Discover emerging discussions before they get popular

Args:
    page: Page number for pagination (0-indexed). Use page=1 to get more topics.

Returns a list of TopicSummary objects with:
- id: Topic ID
- title: Topic title
- posts_count: Number of posts
- created_at: When the topic was created
- category_id: Which forum section it's in

Tip: New topics with high view counts may indicate important news.

Implementation Reference

• src/uscardforum/server_tools/topics.py:49-79 (handler)

  MCP tool handler for get_new_topics. Decorated with @mcp.tool(), defines input schema via Annotated[Field], and implements logic by delegating to the forum client.

  @mcp.tool()
  def get_new_topics(
      page: Annotated[
          int | None,
          Field(default=None, description="Page number for pagination (0-indexed, default: 0)"),
      ] = None,
  ) -> list[TopicSummary]:
      """
      Fetch the latest/newest topics from USCardForum.
  
      Returns recently created topics sorted by creation time (newest first).
      These may have fewer replies but contain fresh information.
  
      Use this to:
      - Find newly posted deals or offers
      - See fresh questions from the community
      - Discover emerging discussions before they get popular
  
      Args:
          page: Page number for pagination (0-indexed). Use page=1 to get more topics.
  
      Returns a list of TopicSummary objects with:
      - id: Topic ID
      - title: Topic title
      - posts_count: Number of posts
      - created_at: When the topic was created
      - category_id: Which forum section it's in
  
      Tip: New topics with high view counts may indicate important news.
      """
      return get_client().get_new_topics(page=page)

• src/uscardforum/server_tools/__init__.py:56-63 (registration)

  Re-exports the get_new_topics tool from topics.py, making it available when importing from server_tools package. Importing here triggers the @mcp.tool() registration.

  from .topics import (
      get_all_topic_posts,
      get_hot_topics,
      get_new_topics,
      get_top_topics,
      get_topic_info,
      get_topic_posts,
  )

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

  Imports and re-exports get_new_topics in the main server entrypoint, ensuring the tool is registered when the server starts.

  get_new_topics,