# Discourse MCP for AI Agents AI Agent Connect > Discourse MCP lets your AI agent handle the heavy lifting of community management. It connects your agent to the Discourse API so you can manage forum topics, track member trust levels, and organize categories without leaving your chat interface. It's built for anyone running a community who needs to move faster than clicking through a dashboard. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Q7G5DQqrvsceOoxNo0BXBNU3sDJ2I6TFo9OnajAS/ai-agent-connect - **Tags:** community-forum, discussion-boards, user-engagement, content-moderation, open-source, api-integration ## Description Imagine you're running a massive community forum. Every day, you're digging through threads, checking who's actually contributing, and trying to figure out which categories are getting the most heat. This Connector changes that by letting your AI agent do the legwork for you. Instead of manual searching, you can just ask your agent to pull up the latest trending discussions or find out who the most trusted members are in a specific group. It handles the boring stuff like listing out category trees or checking site configurations so you can focus on the actual conversations. Because Vinkius makes it so easy to plug this into your existing workflow, you can pivot from a high-level overview of community health to a granular look at a specific user's history in seconds. You're not just automating tasks; you're getting a research assistant that knows your forum inside and out. It's about having a clear picture of your community's pulse without the tab fatigue. ## Tools ### list_forum_categories Get a list of all public categories in your Discourse instance. Use this to quickly see your forum's structural layout. ### list_group_members See every user who belongs to a specific community group. It helps you audit permissions and group memberships easily. ### list_community_groups List all the different user groups configured in your community. This gives you a bird's-eye view of your group structures. ### list_latest_topics Find the most recent topics across all categories. It's a quick way to see what's happening on the forum right now. ### list_trending_discussions Identify which topics are getting the most engagement right now. Use this to spot what's actually capturing attention. ### search_community_content Search for specific topics, posts, or users using a keyword. This lets you find specific information without manual scrolling. ### get_site_configuration Get the general settings and metadata for your Discourse site. This helps your agent understand the basic setup of your forum. ### get_topic_details Pull the full content and post history for a specific topic. Use this to see the entire conversation flow in one place. ### get_user_profile Look up a user's profile details using their username. It's the fastest way to see a member's trust level and history. ### list_active_members See a list of users currently active in your community. This is perfect for monitoring real-time engagement. ## Prompt Examples **Prompt:** ``` Who are the most active people in the community right now? ``` **Response:** ``` I've pulled the list of currently active members for you: | Username | Status | | :--- | :--- | | **tech_guru** | Active | | **dev_dan** | Active | | **community_queen** | Active | Would you like me to look up the profile for any of these users? ``` **Prompt:** ``` Show me the profile for 'tech_guru'. ``` **Response:** ``` Here is the profile for **tech_guru**: * **Trust Level:** 4 (Power User) * **Joined:** January 12, 2023 * **Stats:** 42 topics created, 156 posts * **Groups:** Moderators, VIP_Members Should I check their recent activity or find their latest topics? ``` **Prompt:** ``` What's trending today? ``` **Response:** ``` The following topics are seeing the highest engagement right now: 1. **Major System Update** (32 new posts today) 2. **Community Guidelines RFC** (15 new posts today) 3. **New Feature Requests** (9 new posts today) I can pull the full content for any of these if you'd like to see the discussion. ``` ## Capabilities ### Pull trending discussions Identify which topics are getting the most engagement right now. ### Search community content Find specific topics, posts, or users using a keyword. ### View user profiles Look up detailed profile information and trust levels for any member. ### List forum categories Get a complete list of all public categories in your Discourse instance. ### Identify active members See a list of users currently active in your community. ### Check group memberships See every user who belongs to a specific community group. ### Get topic details Pull the full content and post history for a specific forum topic. ## Use Cases ### Rapid Moderator Fact-Checking A moderator needs to check if a user has a history of issues. They ask the agent to pull the profile and trust level before deciding on a ban. ### Content Trend Analysis A manager wants to know what's popular. They ask the agent to list trending discussions to see what topics need more content. ### Forum Structure Audit A new staff member needs to know the forum structure. They ask the agent to list all public categories and site configurations. ### Group Membership Verification An admin wants to see who's in the VIP group. They ask the agent to list group members to verify the list. ## Benefits - Get a pulse on community health by using list_trending_discussions to see what people actually care about right now. - Speed up moderation by using get_user_profile to instantly check a member's history and trust level before taking action. - Organize your content better by using list_forum_categories to see how your forum structure actually looks. - Spot active contributors quickly with list_active_members to see who's participating in real time. - Manage permissions more easily by using list_group_members to see exactly who is in which group. - Find specific information faster by using search_community_content instead of manually scrolling through pages. ## How It Works The bottom line is it turns your Discourse forum into a searchable, actionable data source for your AI. 1. Connect the Discourse MCP to your AI client using your API key and instance URL. 2. Grant the agent permission to access your forum data. 3. Start asking questions about your community members, topics, or categories. ## Frequently Asked Questions **Can the Discourse MCP help me moderate my forum?** Yes, it helps you do research faster. You can quickly check user trust levels and history before taking action on a post or a report. **How do I see which users are in a specific group?** You can just ask your agent to list the members of a specific group. It will pull the full list of usernames for you instantly. **Can I use this to find the most popular topics?** Absolutely. You can ask your agent to identify trending discussions to see what topics are currently getting the most engagement. **Does the Discourse MCP show user trust levels?** Yes, it can pull detailed profile information, including the trust level assigned to a specific member. **Can I see the full layout of my forum categories?** Yes, you can ask your agent to list all public categories to get a clear view of your forum's structure and settings. **Is this good for community managers?** It's specifically designed for community managers who need to query data without manual clicking. It helps you monitor health and engagement much faster. **How do I get Discourse API credentials?** Log in to your Discourse instance as an administrator, navigate to **Admin > API**, and click **Generate API Key**. You will also need your administrative username. **Can the agent post new replies?** This integration currently focuses on listing and retrieving community data for analysis. Posting new topics or replies should be managed through the Discourse web interface or mobile app. **Does the integration support private categories?** Yes, as long as the provided API Username and Key have the necessary permissions, the agent can list and retrieve information from any category you have access to, including private ones.