USCardForum

You can run the USCardForum MCP Server to programmatically access and navigate USCardForum content through a strongly typed MCP interface. It lets you discover topics, read content, inspect user activity, and perform authenticated actions against a Discourse-based forum, all through a unified API layer.

How to use

Use a compatible MCP client to connect to the server via one of the supported transports. You can operate discovery, reading, user research, and authentication workflows through the 22 available tools. If you deploy publicly, you can require a bearer token for web access. You will interact with the server’s domain models (Topic, Post, User, Notification, etc.) that are returned in strongly typed forms so you can rely on consistent data shapes in your application.

How to install

Prerequisites: Install Python and a Python virtual environment, and have a supported MCP client ready to connect. The server can be run locally or deployed to a hosting platform that supports Python MCP servers.

# Prereqs: ensure Python is installed
# Create a project directory and navigate into it
mkdir uscardforum
cd uscardforum

# Optional: set up a virtual environment
python -m venv .venv
source .venv/bin/activate  # on Windows use .venv\Scripts\activate

# Install the MCP package in editable mode (as shown in the source flow)
pip install -e .

# Run the server locally in stdio mode (Cursor integrations suggest using uv as the runtime)
uv sync
uv run uscardforum

Configuration and usage notes

Configure your deployment to expose the MCP endpoint at a public URL if you plan to connect from remote clients. You can run in standard input/output mode for local development or switch to HTTP streamable mode for web deployments.

Additional sections

Configuration, security, and usage details follow. Use the provided environment variables to tailor authentication, forum access, and deployment behavior. For local development, you can enable auto-login to the forum by setting credentials in the environment. When deploying to web environments, consider enabling streamable-http mode with a bearer token to protect access.

Configuration

Environment variables referenced by the MCP server and the deployment examples include the following. These control transport, authentication, and forum access.

Troubleshooting

If you encounter authentication or network issues, verify the transport mode and any required tokens. Ensure the MCP endpoint is reachable at the configured URL and that the client supplies the correct Authorization header when streamable-http is enabled.

Available tools

get_hot_topics

Return a list of currently trending topics by engagement.

get_new_topics

Return a list of the latest topics by creation time.

get_top_topics

Return top topics by a chosen period (daily/weekly/monthly/yearly).

search_forum

Perform a full-text search with operators and filters.

get_categories

Provide a mapping from category ID to category name.

get_topic_info

Fetch topic metadata including post count and other details.

get_topic_posts

Retrieve a portion of posts within a topic for reading.

get_all_topic_posts

Fetch all posts for a topic with automatic pagination.

get_user_summary

Retrieve a profile overview and statistics for a user.

get_user_topics

List topics created by a specific user.

get_user_replies

Show the user’s reply history.

get_user_actions

Get the full activity feed of a user.

get_user_badges

List badges earned by a user.

get_user_following

Show who a user follows.

get_user_followers

Show who follows a user.

get_user_reactions

List reactions given and received by a user.

list_users_with_badge

Find users who have a specific badge.

login

Authenticate with forum credentials to obtain an authenticated session.

get_current_session

Check whether a user is authenticated and retrieve the current session details.

get_notifications

Fetch notifications for the authenticated user.

bookmark_post

Bookmark a post for later reference.

subscribe_topic

Set notification preferences for a topic.