# Discourse MCP for AI Agents MCP > Discourse MCP equips your AI agent with complete control over community forums. It lets you manage topics, research user profiles, track group memberships, and monitor entire category structures through natural conversation. Stop clicking through dashboards; start asking questions about your community's health. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Tags:** community-forum, discussion-boards, user-engagement, content-moderation, open-source, api-integration ## Description This MCP connects your AI client directly to the Discourse platform, giving your agent deep visibility into your online community. You can manage everything from tracking new discussion threads to researching specific user history and group alignment—all without leaving your chat window. Instead of logging in and clicking through multiple sections just to get a snapshot, you simply ask your agent what's happening. Need to know who belongs to the 'Premium Users' group? Or maybe you want to find out which topics are generating buzz right now? Your agent pulls that data instantly. When you connect it via Vinkius, your AI client can orchestrate complex moderation tasks and content strategy analysis through simple conversation. It turns a massive forum into an actionable data source. ## Tools ### get_site_configuration Retrieves general site settings and metadata for your Discourse instance, giving you an overview of platform limits and status. ### get_topic_details Pulls all posts and the complete content history for a single discussion topic. ### get_user_profile Fetches detailed profile data for one specific user based on their username. ### list_active_members Provides a list of all users currently active in the community (requires admin access). ### list_forum_categories Lists every public category configured on the platform, including structural relationships. ### list_group_members Generates a roster of all users belonging to a specified community group. ### list_community_groups Lists every user group configured within the entire community structure. ### list_latest_topics Returns a list of all discussion topics that were created most recently across the platform. ### list_trending_discussions Identifies and lists topics that have seen the highest amount of engagement over a recent period. ### search_community_content Searches across all topics, posts, and user names for content matching a specific keyword or phrase. ## Prompt Examples **Prompt:** ``` What are the most talked-about topics this week? ``` **Response:** ``` **Top 3 Trending Discussions** 1. **Major System Update:** (25 new posts today) - Focus is on API changes. 2. **Community Guidelines RFC:** (12 new posts) - High disagreement, requires moderator review. 3. **Q2 Feedback Thread:** (7 new posts) - Positive sentiment, needs action items. I can pull the full post list for any of these if you want to see who started it. ``` **Prompt:** ``` Who are the premium members and what groups are they in? ``` **Response:** ``` **Premium Group Members Roster** * john_doe (Trust Level 3 - Regular): Member of 'Moderators' and 'Beta Testers'. * jane_smith (Trust Level 4 - Power User): Member of 'Beta Testers' only. * admin_bot (Trust Level 5 - Admin): Member of all groups listed. ``` **Prompt:** ``` Find me any posts about payment issues from new users. ``` **Response:** ``` I found three relevant discussions: * **Topic: Billing Question:** Contains 4 posts. User 'newbie_user' mentioned a payment failure. * **Topic: Subscription Help:** Contains 12 posts. Multiple users discussed payments, but no specific failures were noted in the summary. The user profile for 'billing_help' shows they joined yesterday and are currently listed as an active member. ``` ## Capabilities ### Retrieve general platform settings Fetches metadata and configuration data about the entire Discourse site instance. ### Get full topic content details Retrieves every post and the overall body content for a specific discussion thread. ### Search all community content by keyword Searches across users, posts, and topics for any content matching your provided phrase or term. ## Use Cases ### Investigating a new user's behavior A moderator suspects 'john_doe' is posting off-topic. They ask their agent to run `get_user_profile` and also check if the user belongs to sensitive groups using `list_group_members`. The agent returns their full history, trust level, and group affiliations in one response. ### Identifying evergreen content needs A Content Strategist wants to know what discussions are worth turning into blog posts. They ask the agent to run `list_trending_discussions` which highlights high-engagement threads, providing immediate material ideas. ### Mapping out user permissions The Admin needs a full picture of who can do what. The agent runs `list_community_groups` to get all groups, and then iterates through them using `list_group_members` to create a master roster. ### Responding to a sudden content spike The team notices a flurry of posts on 'Q2 Feedback.' They ask the agent to run `get_topic_details` for that specific topic, instantly providing all 50 new comments and allowing them to respond immediately. ## Benefits - Quickly assess the health of your discussions. Use `list_trending_discussions` to pinpoint what topics are gaining momentum, allowing you to focus moderation efforts where they're needed most. - Never forget who has access to what. With `list_community_groups`, you can map out all user roles and then use `list_group_members` to see exactly who belongs in each one. - Deep dive into user behavior. You can check a single person's history by calling `get_user_profile`, giving moderators the context they need before escalating an issue. - Keep track of content flow. If you use `list_latest_topics` and then follow up with `get_topic_details`, your agent gives you both the summary list and the full post count immediately. - Understand platform limitations. Use `get_site_configuration` to know if there are any API constraints or metadata issues that might affect future automation efforts. ## How It Works The bottom line is, your AI client handles all the API interaction; you just talk to it like normal. 1. First, connect your AI client to this MCP on Vinkius and authorize access using your Discourse API Key, Username, and instance URL. 2. Next, you prompt your agent with a request, like 'List all users in the Moderators group,' or 'Show me the details for topic X.' 3. Your agent executes the necessary tool calls to pull the required data (user profiles, topic content, or group lists) and presents it back to you in plain text. ## Frequently Asked Questions **How does the Discourse MCP help me manage community discussions?** The MCP lets your AI agent track, list, and retrieve details for any discussion topic or user post. Instead of checking the forum manually, you ask your agent to summarize what's trending or pull the full history on a specific thread. **Can I use the Discourse MCP to check who is in which group?** Yes. Your AI client can list all community groups and then, for any given group name, it generates a complete roster of every user belonging to that specific membership. **What kind of information about users can the Discourse MCP provide?** It provides detailed profile data, including the user's trust level, join date, and how many topics or posts they have created. This is vital context for moderation decisions. **Is this helpful for content strategy planning in Discourse MCP?** Absolutely. You can ask your agent to list all public categories to map out the forum structure, and then run a search across all content using keywords like 'roadmap' or 'feedback' to see what needs attention. **Does the Discourse MCP let me know which users are currently active?** Yes. You can ask your agent to pull a list of currently active community members, giving you an immediate overview of who is online or highly engaged right now.