@discourse/mcp
io.github.discourse/mcp · version 0.3.1 · 30,235 weekly npm downloads · audited 2026-11-03
Notes
Findings
No hidden-instruction or invisible-character findings in any tool, prompt, or resource description.
Claude Connectors Directory readiness
- ✅ Every tool has a title 16 of 16 tools
- ❌ Every tool declares readOnlyHint or destructiveHint Missing on 1 of 16: discourse_select_site
- ✅ Tool names are 64 characters or fewer All within limit
- ❌ Descriptions avoid instructions about model behavior or other tools 1 of 16 descriptions reference other tools or tell the model what it must do: discourse_search_posts
- ✅ No hidden instructions or invisible characters in tool metadata None found
Checks the directory's published tool requirements that are visible from tools/list. Passing them does not guarantee acceptance.
Supply chain
- Install scripts: none
- npm provenance: yes
- Source repository linked: yes
- License: MIT
- Direct dependencies: 2
Tools (16)
| Name | Title | Hint | Description |
|---|---|---|---|
discourse_select_site | Select Site | none | Validate and select a Discourse site. Returns JSON with site URL and title. |
discourse_search | Discourse Search | read-only | Search site content. Returns JSON object with results array of matching topics (id, slug, title) and meta (total, has_more). |
discourse_filter_topics | Filter Topics | read-only | Discover topics through a filtered, top, or hot view. Filtered uses Discourse TopicsFilter syntax; top uses Discourse's authoritative top score and defaults to weekly; hot is defined exactly as daily top (not sentiment, … |
discourse_read_topic | Read Topic | read-only | Read topic metadata and posts. Large post limits can require multiple upstream requests. For moderation queues, prefer reviewable list/detail evidence instead of fanning this tool out across flagged topics. |
discourse_read_post | Read Post | read-only | Read a specific post. Returns JSON with id, topic_id, post_number, username, created_at, and raw content. |
discourse_read_topic_posts | Read Selected Topic Posts | read-only | Read exact, earliest, latest, around-post, or username-filtered topic evidence. Selection is bounded to 50 posts and reports the visible stream size without claiming the entire topic was loaded. |
discourse_search_posts | Search Posts | read-only | Search post-level evidence with Discourse query syntax. Unlike discourse_search, this preserves matched posts, highlighted blurbs, authors, topics, categories, and truthful bounded continuation. This is keyword search, n… |
discourse_get_user | Get User | read-only | Get user info. Returns JSON with id, username, name, trust_level, created_at, bio, admin, and moderator. |
discourse_list_user_posts | List User Posts | read-only | Get paginated list of user posts/replies. Returns JSON object with posts array (id, topic_id, post_number, slug, title, created_at, excerpt, category_id) and meta (page, limit, has_more). |
discourse_list_users | List Users | read-only | List users via admin API. Requires admin API key. Returns ~100 users per page (Discourse's fixed page size). Returns JSON with users array and pagination meta. |
discourse_get_chat_messages | Get Chat Messages | read-only | Get messages from a chat channel. Returns JSON object with channel_id, messages array (id, username, created_at, message, edited, thread_id, in_reply_to_id), and meta. |
discourse_get_draft | Get Draft | read-only | Retrieve a specific draft by key. Returns JSON with draft_key, sequence, and parsed data (title, reply, categoryId, tags, action). |
discourse_get_query | Get Data Explorer Query | read-only | Get full details of a Data Explorer query including SQL and parameters. Requires admin API key. |
discourse_run_query | Run Data Explorer Query | read-only | Execute a Data Explorer query with parameters. Returns columns, rows, result_count, duration_ms. Queries run in read-only transactions with 10-second timeout. Requires admin API key. |
discourse_list_private_messages | List Private Messages | read-only | List authenticated personal or group private-message mailboxes. Returns normalized JSON messages and pagination metadata. |
discourse_read_private_message | Read Private Message | read-only | Read an authenticated private message, its posts, and direct allowed-user and allowed-group records. Rejects public topics. |
Check your own setup
npx mcpvetter scan --liveBadge
Add this to a README:
[](https://mcpvetter.com/servers/discourse-mcp)Publish this server?
Get the MCPVetter verified badge, a re-audit within 24 hours of every npm release, and an email whenever tools, findings, or Claude directory readiness change. $29 per server per month. You prove ownership first, free.