get_new_topics
Fetch recently created topics from USCardForum to discover new deals, questions, and discussions before they become popular.
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (0-indexed, default: 0) |
Implementation Reference
- 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,