# discource-mcp-tools Server

> Manage and explore forum communities by searching topics, reading posts, and viewing user profiles. Facilitate communication through chat channels, draft manage

- Price: Free to connect · provider's own fees apply
- URL: https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-king-of-the-grackles-discourse-forum-mcp
- Source: Smithery https://smithery.ai/server/king-of-the-grackles/discourse-forum-mcp
- Rank this week: #43 (score 56)

## Install

```
npx -y @smithery/cli install king-of-the-grackles/discourse-forum-mcp --client claude
```
- `site` (optional): Discourse instance URL (e.g. https://meta.discourse.org)
- `api_key` (optional): Discourse Admin API key for full access
- `log_level` (optional): Logging verbosity: debug, info, warn, or error
- `read_only` (optional): Restrict to read-only operations
- `tools_mode` (optional): Tool selection mode: auto, all, read, write, or search
- `allow_writes` (optional): Enable write operations like creating posts and topics (true/false)
- `api_username` (optional): Discourse API username (e.g. system)
- `user_api_key` (optional): Discourse User API key (alternative to admin API key)
- `max_read_length` (optional): Maximum character length for content reads
- `user_api_client_id` (optional): Client ID for User API key authentication
- Remote: https://discourse-forum-mcp--king-of-the-grackles.run.tools

## Tools (15)

- `discourse_select_site`: Validate and select a Discourse site for subsequent tool calls. Verifies the site is reachable and retrieves its title.
- `discourse_search`: Search Discourse site content including topics, posts, and users. Use search operators like @username, tag, category:name for filtered results.
- `discourse_read_topic`: Read a Discourse topic including its metadata (title, category, tags) and posts. Supports pagination for long topics.
- `discourse_read_post`: Read a specific post by its ID. Returns the post content, author, creation date, and link to the post.
- `discourse_list_categories`: List all categories visible to the current user. Returns category names and topic counts. Useful for discovering where to post or search.
- `discourse_list_tags`: List all available tags on the Discourse site (if tagging is enabled). Returns tag names and usage counts. Use tags in search queries with tagname.
- `discourse_get_user`: Get information about a Discourse user by username. Returns name, trust level, join date, bio, and profile link.
- `discourse_list_user_posts`: Get a paginated list of posts and replies by a specific user, with the most recent first. Returns 30 posts per page. Includes topic title, post date, excerpt, and direct links.
- `discourse_filter_topics`: Filter topics with a concise query language: use key:value tokens separated by spaces; category/categories for categories (comma = OR, '=category' = without subcats, '-' prefix = e…
- `discourse_list_chat_channels`: List all public chat channels visible to the current user. Returns channel information including title, description, and member counts. Supports filtering and pagination.
- `discourse_list_user_chat_channels`: List all chat channels for the currently authenticated user, including both public channels they're a member of and direct message channels. Includes unread tracking information.
- `discourse_get_chat_messages`: Get messages from a chat channel with flexible pagination and date-based filtering.
- `discourse_list_drafts`: List all drafts for the current user. Returns draft keys, sequences, and preview content. Use this to find existing drafts before updating them.
- `discourse_get_draft`: Retrieve a specific draft by its key. Common keys: "newtopic" for new topic drafts, "topic<id" for reply drafts.
- `search_discourse_communities`: Discover Discourse forum communities by topic or find similar communities.

## FAQ

### What is the discource-mcp-tools Server?

Manage and explore forum communities by searching topics, reading posts, and viewing user profiles. Facilitate communication through chat channels, draft manage. It is listed on Smithery and ranks #43 (score 56) in ListeningMind.AI's weekly picks.

### How do I install the discource-mcp-tools Server?

Run npx -y @smithery/cli install king-of-the-grackles/discourse-forum-mcp --client claude in a terminal to add it to Claude Desktop. For Cursor, use --client cursor.

### Do I need an API key?

The provider lists no required settings.

### Which tools does it provide?

15 tools: discourse_select_site, discourse_search, discourse_read_topic, discourse_read_post, discourse_list_categories, discourse_list_tags, discourse_get_user, discourse_list_user_posts, discourse_filter_topics, discourse_list_chat_channels, discourse_list_user_chat_channels, discourse_get_chat_messages.

### How much does it cost?

Free to connect · provider's own fees apply. The provider may charge for use on its own terms.

### Can I trust it?

Checks passed: Live endpoint, Clear description. Skim a server or repository you have not used before connecting it.

