On by default

Search

Discourse Search

read-onlyidempotentopen-world

discourse_search

Search site content. Returns JSON object with results array of matching topics (id, slug, title) and meta (total, has_more).

Discourse Search

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_search",
    "arguments": {
        "query": "string",
        "max_results": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_search",
  "arguments": {
    "query": "string",
    "max_results": 1
  }
});

result = await session.call_tool("discourse_search", arguments={
  "query": "string",
  "max_results": 1
})

Parameters

querystringrequired

Search query

max_resultsinteger[1, 50]

Filter Topics

read-onlyidempotentopen-world

discourse_filter_topics

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, controversy, or real-time velocity). Returns a uniform rich topic projection and truthful pagination metadata.

Filter Topics

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_filter_topics",
    "arguments": {
        "filter": "string",
        "view": "filtered",
        "top_period": "daily",
        "page": 0,
        "per_page": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_filter_topics",
  "arguments": {
    "filter": "string",
    "view": "filtered",
    "top_period": "daily",
    "page": 0,
    "per_page": 1
  }
});

result = await session.call_tool("discourse_filter_topics", arguments={
  "filter": "string",
  "view": "filtered",
  "top_period": "daily",
  "page": 0,
  "per_page": 1
})

Parameters

filterstring

TopicsFilter query (required for the filtered view)

viewstringfilteredtophotfiltered

top_periodstringdailyweeklymonthlyquarterlyyearlyall

Top period (top view only; defaults to weekly)

pageinteger>= 0

Page number (0-based, default: 0)

per_pageinteger[1, 50]

Items per page (default 20, max 50)

Search Posts

read-onlyidempotentopen-world

discourse_search_posts

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, not Discourse AI semantic search.

Search Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_search_posts",
    "arguments": {
        "query": "string",
        "page": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_search_posts",
  "arguments": {
    "query": "string",
    "page": 1
  }
});

result = await session.call_tool("discourse_search_posts", arguments={
  "query": "string",
  "page": 1
})

Parameters

querystringrequired

pageinteger[1, 10]

Docs by Sourcey