get_notifications

Fetch user notifications from USCardForum to check replies, mentions, likes, and topic updates with optional filters for unread items and time ranges.

Instructions

Fetch your notifications. REQUIRES AUTHENTICATION.

Args:
    since_id: Only get notifications newer than this ID (optional)
    only_unread: Only return unread notifications (default: False)
    limit: Maximum number to return (optional)

Must call login() first.

Returns a list of Notification objects with:
- id: Notification ID
- notification_type: Type of notification
- read: Whether read
- topic_id: Related topic
- post_number: Related post
- created_at: When created

Use to:
- Check for new replies to your posts
- See mentions and likes
- Track topic updates you're watching

Input Schema

TableJSON Schema

Name	Required	Description
`since_id`	No	Only get notifications newer than this ID
`only_unread`	No	Only return unread notifications
`limit`	No	Maximum number to return

Implementation Reference

src/uscardforum/server_tools/auth.py:78-119 (handler)

The primary MCP tool handler for 'get_notifications'. Includes input schema via Annotated Pydantic Fields (since_id, only_unread, limit) and delegates execution to the client API after authentication.

@mcp.tool()
def get_notifications(
    since_id: Annotated[
        int | None,
        Field(default=None, description="Only get notifications newer than this ID"),
    ] = None,
    only_unread: Annotated[
        bool,
        Field(default=False, description="Only return unread notifications"),
    ] = False,
    limit: Annotated[
        int | None,
        Field(default=None, description="Maximum number to return"),
    ] = None,
) -> list[Notification]:
    """
    Fetch your notifications. REQUIRES AUTHENTICATION.

    Args:
        since_id: Only get notifications newer than this ID (optional)
        only_unread: Only return unread notifications (default: False)
        limit: Maximum number to return (optional)

    Must call login() first.

    Returns a list of Notification objects with:
    - id: Notification ID
    - notification_type: Type of notification
    - read: Whether read
    - topic_id: Related topic
    - post_number: Related post
    - created_at: When created

    Use to:
    - Check for new replies to your posts
    - See mentions and likes
    - Track topic updates you're watching
    """
    return get_client().get_notifications(
        since_id=since_id, only_unread=only_unread, limit=limit
    )

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

Registers the 'get_notifications' tool by importing it (line 25) into the MCP server entrypoint module, making it available when the server runs.

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

src/uscardforum/server_tools/__init__.py:34-40 (registration)
Re-exports the 'get_notifications' tool (line 37) from the auth submodule for convenient import in the server tools package.
```
from .auth import (
    bookmark_post,
    get_current_session,
    get_notifications,
    login,
    subscribe_topic,
)
```

USCardForum MCP Server