Discourse Search

Discourse Search

ashdevfr

Connects to Discourse forums to search and retrieve posts through API queries. Requires forum API credentials to access content.

Enables searching and retrieving content from Discourse forums through a single tool that queries posts using the discourse2 npm package.

5288 views5Local (stdio)

What it does

  • Search posts across Discourse forums
  • Query forum content by keywords
  • Retrieve post data and metadata
  • Access multiple Discourse instances

Best for

Community managers analyzing forum discussionsResearchers gathering data from Discourse communitiesDevelopers building forum integrations
Docker and NPX deployment optionsUses official discourse2 npm package

About Discourse Search

Discourse Search is a community-built MCP server published by ashdevfr that provides AI assistants with tools and capabilities via the Model Context Protocol. Discourse Search lets you quickly search and retrieve posts from Discourse forums using the powerful discourse2 npm pack It is categorized under search web.

How to install

You can install Discourse Search in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

Discourse Search is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

Discourse MCP Server

Node.js server implementing Model Context Protocol (MCP) for Discourse search operation.

Features

  • Search Posts on a Discourse forum using MCP protocol.

API

Tools

  • search_posts
    • Search posts on a Discourse forum
    • Input: query (string)
    • Returns an array of post objects

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "discourse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "DISCOURSE_API_URL=https://try.discourse.org",
        "-e", "DISCOURSE_API_KEY=1234",
        "-e", "DISCOURSE_API_USERNAME=ash",
        "ashdev/discourse-mcp-server"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "discourse": {
      "command": "npx",
      "args": [
        "-y",
        "@ashdev/discourse-mcp-server"
      ],
      "env": {
        "DISCOURSE_API_URL": "https://try.discourse.org",
        "DISCOURSE_API_KEY": "1234",
        "DISCOURSE_API_USERNAME": "ash" 
      }
    }
  }
}

Build

Docker build:

docker build -t ashdev/discourse-mcp-server .

Alternatives

Related Skills

Browse all skills
x-research

General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert opinions. Works like a web research agent but uses X as the source. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "/x-research", (2) user is working on something where recent X discourse would provide useful context (new library releases, API changes, product launches, cultural events, industry drama), (3) user wants to find what devs/experts/community thinks about a topic. NOT for: posting tweets, account management, or historical archive searches beyond 7 days.

1
google-official-seo-guide

Official Google SEO guide covering search optimization, best practices, Search Console, crawling, indexing, and improving website search visibility based on official Google documentation

119
ux-writing

Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and usability, reviewing UI strings, or improving existing interface copy. Applies UX writing best practices based on four quality standards — purposeful, concise, conversational, and clear. Includes accessibility guidelines, research-backed benchmarks (sentence length, comprehension rates, reading levels), expanded error patterns, tone adaptation frameworks, and comprehensive reference materials.

31
last30days

Research a topic from the last 30 days on Reddit + X + Web, become an expert, and write copy-paste-ready prompts for the user's target tool.

27
browser-automation

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. Triggers include "browse", "navigate to", "go to website", "extract data from webpage", "screenshot", "web scraping", "fill out form", "click on", "search for on the web". When taking actions be as specific as possible.

23
seo-optimizer

Search Engine Optimization specialist for content strategy, technical SEO, keyword research, and ranking improvements. Use when optimizing website content, improving search rankings, conducting keyword analysis, or implementing SEO best practices. Expert in on-page SEO, meta tags, schema markup, and Core Web Vitals.

21