e ` (default: auto) - `--site `: Tether MCP to a single site and hide `discourse_select_site`. - `--default-search `: Unconditionally prefix every search query (e.g., `tag:ai order:latest-post`). - `--max-read-length `: Maximum characters returned for post content (default 50000). Applies to `discourse_read_post` and per-post content in `discourse_read_topic`. The tools prefer `raw` content by requesting `include_raw=true`. - `--transport ` (default: stdio): Transport type. Use `stdio` for standard input/output (default), or `http` for Streamable HTTP transport (stateless mode with JSON responses). - `--port ` (default: 3000): Port to listen on when using HTTP transport. - `--cache_dir ` (reserved) - `--profile ` (see below) - **Profile file** (keep secrets off the command line) ```json { "auth_pairs": [ { "site": "https://try.discourse.org", "api_key": "", "api_username": "system" }, { "site": "https://example.com", "user_api_key": "", "user_api_client_id": "" } ], "read_only": false, "allow_writes": true, "log_level": "info", "tools_mode": "auto", "site": "https://try.discourse.org", "default_search": "tag:ai order:latest-post", "max_read_length": 50000, "transport": "stdio", "port": 3000 } ``` Run with: ```bash node dist/index.js --profile /absolute/path/to/profile.json ``` Flags still override values from the profile. - **Remote Tool Execution API (optional)** - With `tools_mode=auto` (default) or `tool_exec_api`, the server discovers remote tools via GET `/ai/tools` after you select a site (or immediately at startup if `--site` is provided) and registers them dynamically. Set `--tools_mode=discourse_api_only` to disable remote tool discovery. - **Networking & resilience** - Retries on 429/5xx with backoff (3 attempts). - Lightweight in‑memory GET cache for selected endpoints. - **Privacy** - Secrets are redacted in logs. Errors are returned as human‑readable messages to MCP clients. ## Tools Built‑in tools (always present unless noted): - `discourse_search` - Input: `{ query: string; with_private?: boolean; max_results?: number (1–50, default 10) }` - Output: text summary plus a compact footer like: ```json { "results": [{ "id": 123, "url": "https://…", "title": "…" }] } ``` - `discourse_read_topic` - Input: `{ topic_id: number; post_limit?: number (1–20, default 5) }` - `discourse_read_post` - Input: `{ post_id: number }` - `discourse_list_categories` - Input: `{}` - `discourse_list_tags` - Input: `{}` - `discourse_get_user` - Input: `{ username: string }` - `discourse_filter_topics` - Input: `{ filter: string; page?: number (default 1); per_page?: number (1–50) }` - Query language (succinct): key:value tokens separated by spaces; category/categories (comma = OR, `=category` = without subcats, `-` prefix = exclude); tag/tags (comma = OR, `+` = AND) and tag_group; status:(open|closed|archived|listed|unlisted|public); personal `in:` (bookmarked|watching|tracking|muted|pinned); dates: created/activity/latest-post-(before|after) with `YYYY-MM-DD` or relative days `N`; numeric: likes[-op]-(min|max), posts-(min|max), posters-(min|max), views-(min|max); order: activity|created|latest-post|likes|likes-op|posters|title|views|category with optional `-asc`; free text terms are matched. - `discourse_create_post` (only when writes enabled; see Write safety) - Input: `{ topic_id: number; raw: string (≤ 30k chars) }` - `discourse_create_topic` (only when writes enabled; see Write safety) - Input: `{ title: string; raw: string (≤ 30k chars); category_id?: number; tags?: string[] }` - `discourse_create_user` (only when writes enabled; see Write safety) - Input: `{ username: string (1-20 chars); email: string; name: string; password: string; active?: boolean; approved?: boolean }` - `discourse_create_category` (only when writes enabled; see Write safety) - Input: `{ name: string; color

#discourse

Discourse Mcp Server