Discourse Search MCP Server

The Discourse Search MCP provides a seamless way to search for posts on any Discourse forum directly from your AI assistant. By connecting to a Discourse instance through its API, this tool enables you to find relevant discussions, answers, and information without leaving your conversation. With simple configuration options for API credentials and forum URL, you can quickly set up access to public or private Discourse communities. This integration is perfect for teams that use Discourse for knowledge management, community engagement, or support.

Overview

The Discourse Search MCP allows you to search for posts on any Discourse forum directly through your AI assistant. This integration is particularly useful for teams that rely on Discourse for knowledge management, community discussions, or support.

Installation

You can run the Discourse MCP Server using either Docker or NPX. Both methods require you to provide your Discourse API credentials as environment variables.

Required Environment Variables

DISCOURSE_API_URL: The URL of your Discourse forum (e.g., "https://try.discourse.org")
DISCOURSE_API_KEY: Your Discourse API key
DISCOURSE_API_USERNAME: Your Discourse username

Docker Installation

To use the Docker installation method, add the following configuration to your client:

{
  "mcpServers": {
    "discourse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "DISCOURSE_API_URL=https://your-discourse-forum.com",
        "-e", "DISCOURSE_API_KEY=your-api-key",
        "-e", "DISCOURSE_API_USERNAME=your-username",
        "ashdev/discourse-mcp-server"
      ]
    }
  }
}

NPX Installation

Alternatively, you can use NPX to run the server:

{
  "mcpServers": {
    "discourse": {
      "command": "npx",
      "args": [
        "-y",
        "@ashdev/discourse-mcp-server"
      ],
      "env": {
        "DISCOURSE_API_URL": "https://your-discourse-forum.com",
        "DISCOURSE_API_KEY": "your-api-key",
        "DISCOURSE_API_USERNAME": "your-username"
      }
    }
  }
}

Getting Discourse API Credentials

To obtain your Discourse API credentials:

Log in to your Discourse forum as an administrator
Go to Admin > API
Generate a new API key with appropriate permissions
Note your API key and the username associated with it

Usage

Once installed, you can use the Discourse Search MCP to search for posts on your configured Discourse forum. Simply ask your AI assistant to search for specific topics or keywords on your Discourse forum, and it will use the MCP to retrieve relevant posts.

Discourse Search MCP Server

search_posts