Community (opt-in)

Activity

Get Post Replies

read-onlyidempotentopen-world

discourse_get_post_replies

Read reply relationships for a post as recursive descendant IDs, bounded rich direct replies, or the upstream-bounded ancestor history. Preserves upstream ordering and references.

Get Post Replies

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_post_replies",
    "arguments": {
        "post_id": 0,
        "mode": "reply_ids",
        "after_post_number": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_post_replies",
  "arguments": {
    "post_id": 0,
    "mode": "reply_ids",
    "after_post_number": 0
  }
});

result = await session.call_tool("discourse_get_post_replies", arguments={
  "post_id": 0,
  "mode": "reply_ids",
  "after_post_number": 0
})

Parameters

post_idintegerrequired

modestringreply_idsdirect_repliesreply_history

reply_ids returns recursive descendant IDs; direct_replies returns up to 20 rich direct replies; reply_history returns ancestors

after_post_numberinteger>= 0

List Latest Posts

read-onlyidempotentopen-world

discourse_list_latest_posts

List the site's latest visible posts using Discourse's fixed 50-post page and post-ID cursor. Anonymous upstream responses expire after one minute; results are a feed, not an exhaustive history.

List Latest Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_latest_posts",
    "arguments": {
        "before_post_id": 0,
        "replies_only": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_latest_posts",
  "arguments": {
    "before_post_id": 0,
    "replies_only": true
  }
});

result = await session.call_tool("discourse_list_latest_posts", arguments={
  "before_post_id": 0,
  "replies_only": true
})

Parameters

before_post_idinteger

replies_onlyboolean

Get Topic View Stats

read-onlyidempotentopen-world

discourse_get_topic_view_stats

Get up to 300 ascending daily topic view counts. Views combine anonymous and logged-in views; they are not unique viewers or an engagement judgment.

Get Topic View Stats

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_topic_view_stats",
    "arguments": {
        "topic_id": 0,
        "from": "string",
        "to": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_topic_view_stats",
  "arguments": {
    "topic_id": 0,
    "from": "string",
    "to": "string"
  }
});

result = await session.call_tool("discourse_get_topic_view_stats", arguments={
  "topic_id": 0,
  "from": "string",
  "to": "string"
})

Parameters

topic_idintegerrequired

fromstring

tostring

Get User Summary

read-onlyidempotentopen-world

discourse_get_user_summary

Get profile-visible aggregate user activity, top topics/replies/links, interaction partners, categories, badges, likes, visits, reading, and post/topic counts. Missing metrics remain null when hidden or unavailable.

Get User Summary

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_user_summary",
    "arguments": {
        "username": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_user_summary",
  "arguments": {
    "username": "string"
  }
});

result = await session.call_tool("discourse_get_user_summary", arguments={
  "username": "string"
})

Parameters

usernamestringrequired

List User Actions

read-onlyidempotentopen-world

discourse_list_user_actions

List a user's visible activity using model-friendly action names. Plugin-backed action families can legitimately be empty; emptiness does not prove that a feature is unavailable.

List User Actions

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_user_actions",
    "arguments": {
        "username": "string",
        "acting_username": "string",
        "action_types": [
          "likes"
        ],
        "offset": 0,
        "limit": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_user_actions",
  "arguments": {
    "username": "string",
    "acting_username": "string",
    "action_types": [
      "likes"
    ],
    "offset": 0,
    "limit": 1
  }
});

result = await session.call_tool("discourse_list_user_actions", arguments={
  "username": "string",
  "acting_username": "string",
  "action_types": [
    "likes"
  ],
  "offset": 0,
  "limit": 1
})

List Directory Items

read-onlyidempotentopen-world

discourse_list_directory_items

List user-directory/cohort metrics with authoritative totals and continuation. Supports Discourse periods, ordering, visible groups, page 0-10, and the upstream maximum of 50 rows.

List Directory Items

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_directory_items",
    "arguments": {
        "period": "daily",
        "order": "string",
        "ascending": true,
        "group": "string",
        "page": 0,
        "limit": 1,
        "name": "string",
        "username": "string",
        "exclude_groups": [
          "string"
        ],
        "exclude_usernames": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_directory_items",
  "arguments": {
    "period": "daily",
    "order": "string",
    "ascending": true,
    "group": "string",
    "page": 0,
    "limit": 1,
    "name": "string",
    "username": "string",
    "exclude_groups": [
      "string"
    ],
    "exclude_usernames": [
      "string"
    ]
  }
});

result = await session.call_tool("discourse_list_directory_items", arguments={
  "period": "daily",
  "order": "string",
  "ascending": true,
  "group": "string",
  "page": 0,
  "limit": 1,
  "name": "string",
  "username": "string",
  "exclude_groups": [
    "string"
  ],
  "exclude_usernames": [
    "string"
  ]
})

Parameters

periodstringdailyweeklymonthlyquarterlyyearlyallrequired

orderstring

ascendingboolean

groupstring

pageinteger[0, 10]

limitinteger[1, 50]

namestring

usernamestring

exclude_groupsArray<string>

exclude_usernamesArray<string>

Docs by Sourcey