AI (opt-in)

AI insights

Get Discourse AI Topic Summary

read-onlyidempotentopen-world

discourse_ai_get_topic_summary

Retrieve an existing cached upstream Discourse AI topic summary, including algorithm and staleness evidence. Requires Discourse AI; this tool does not generate or claim complete MCP-authored output.

Get Discourse AI Topic Summary

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_ai_get_topic_summary",
    "arguments": {
        "topic_id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_ai_get_topic_summary",
  "arguments": {
    "topic_id": 0
  }
});

result = await session.call_tool("discourse_ai_get_topic_summary", arguments={
  "topic_id": 0
})

Parameters

topic_idintegerrequired

Discourse AI Semantic Search

read-onlyidempotentopen-world

discourse_ai_semantic_search

Run Guardian-filtered Discourse AI semantic search and return bounded grouped post/topic evidence. Requires Discourse AI embeddings. Results are bounded and expose no fabricated page cursor.

Discourse AI Semantic Search

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_ai_semantic_search",
    "arguments": {
        "query": "string",
        "hyde": false
      }
  }
}

const result = await client.callTool({
  "name": "discourse_ai_semantic_search",
  "arguments": {
    "query": "string",
    "hyde": false
  }
});

result = await session.call_tool("discourse_ai_semantic_search", arguments={
  "query": "string",
  "hyde": false
})

Parameters

querystringrequired

hydeboolean

Explicitly disable HyDE. Omit to use the site's configured behavior; upstream does not reliably support enabling it per request.

List Discourse AI Sentiment Posts

read-onlyidempotentopen-world

discourse_ai_list_sentiment_posts

List staff-visible posts classified positive, negative, or neutral by Discourse AI for an exact category/tag and date window. Classification is model output, not proof of tone, satisfaction, risk, or an argument.

List Discourse AI Sentiment Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_ai_list_sentiment_posts",
    "arguments": {
        "group_by": "category",
        "group_value": "string",
        "start_date": "string",
        "end_date": "string",
        "limit": 1,
        "offset": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_ai_list_sentiment_posts",
  "arguments": {
    "group_by": "category",
    "group_value": "string",
    "start_date": "string",
    "end_date": "string",
    "limit": 1,
    "offset": 0
  }
});

result = await session.call_tool("discourse_ai_list_sentiment_posts", arguments={
  "group_by": "category",
  "group_value": "string",
  "start_date": "string",
  "end_date": "string",
  "limit": 1,
  "offset": 0
})

Parameters

group_bystringcategorytagrequired

group_valuestringrequired

start_datestring

end_datestring

limitinteger[1, 100]

offsetinteger>= 0

Docs by Sourcey