On by default

Private messages

List Private Messages

read-onlyidempotentopen-world

discourse_list_private_messages

List authenticated personal or group private-message mailboxes. Returns normalized JSON messages and pagination metadata.

List Private Messages

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_private_messages",
    "arguments": {
        "username": "string",
        "mailbox": "inbox",
        "group_name": "string",
        "page": 0,
        "per_page": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_private_messages",
  "arguments": {
    "username": "string",
    "mailbox": "inbox",
    "group_name": "string",
    "page": 0,
    "per_page": 1
  }
});

result = await session.call_tool("discourse_list_private_messages", arguments={
  "username": "string",
  "mailbox": "inbox",
  "group_name": "string",
  "page": 0,
  "per_page": 1
})

Parameters

usernamestring

mailboxstringinboxsentarchiveunreadnew

group_namestring

pageinteger>= 0

per_pageinteger[1, 100]

Read Private Message

read-onlyidempotentopen-world

discourse_read_private_message

Read an authenticated private message, its posts, and direct allowed-user and allowed-group records. Rejects public topics.

Read Private Message

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

const result = await client.callTool({
  "name": "discourse_read_private_message",
  "arguments": {
    "topic_id": 0,
    "post_limit": 1,
    "start_post_number": 1
  }
});

result = await session.call_tool("discourse_read_private_message", arguments={
  "topic_id": 0,
  "post_limit": 1,
  "start_post_number": 1
})

Parameters

topic_idintegerrequired

post_limitinteger[1, 50]

Max posts to return (default 5, max 50)

start_post_numberinteger>= 1

Start from this post number (1-based)

Create Private Message

discourse_create_private_message

Create a private message for typed user, group, or email recipients. Unknown emails may create staged users. author_username requires a global API key; the response reports actual attribution.

Create Private Message

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_private_message",
    "arguments": {
        "title": "string",
        "raw": "string",
        "usernames": [
          "string"
        ],
        "group_names": [
          "string"
        ],
        "email_addresses": [
          "string"
        ],
        "author_username": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_private_message",
  "arguments": {
    "title": "string",
    "raw": "string",
    "usernames": [
      "string"
    ],
    "group_names": [
      "string"
    ],
    "email_addresses": [
      "string"
    ],
    "author_username": "string"
  }
});

result = await session.call_tool("discourse_create_private_message", arguments={
  "title": "string",
  "raw": "string",
  "usernames": [
    "string"
  ],
  "group_names": [
    "string"
  ],
  "email_addresses": [
    "string"
  ],
  "author_username": "string"
})

Parameters

titlestringrequired

rawstringrequired

usernamesArray<string>

group_namesArray<string>

email_addressesArray<string>

author_usernamestring

Reply to Private Message

discourse_reply_private_message

Safely reply to an existing private message after verifying its archetype. author_username requires a global API key; the response reports actual attribution.

Reply to Private Message

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_reply_private_message",
    "arguments": {
        "topic_id": 0,
        "raw": "string",
        "reply_to_post_number": 0,
        "author_username": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_reply_private_message",
  "arguments": {
    "topic_id": 0,
    "raw": "string",
    "reply_to_post_number": 0,
    "author_username": "string"
  }
});

result = await session.call_tool("discourse_reply_private_message", arguments={
  "topic_id": 0,
  "raw": "string",
  "reply_to_post_number": 0,
  "author_username": "string"
})

Parameters

topic_idintegerrequired

rawstringrequired

reply_to_post_numberinteger

author_usernamestring

Invite to Private Message

discourse_invite_to_private_message

Add a user or group to a private message, or submit an opaque email invitation. Email success does not confirm delivery or participant access. author_username requires a global API key.

Invite to Private Message

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_invite_to_private_message",
    "arguments": {
        "topic_id": 0,
        "username": "string",
        "group_name": "string",
        "email_address": "string",
        "notify_group_members": true,
        "custom_message": "string",
        "author_username": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_invite_to_private_message",
  "arguments": {
    "topic_id": 0,
    "username": "string",
    "group_name": "string",
    "email_address": "string",
    "notify_group_members": true,
    "custom_message": "string",
    "author_username": "string"
  }
});

result = await session.call_tool("discourse_invite_to_private_message", arguments={
  "topic_id": 0,
  "username": "string",
  "group_name": "string",
  "email_address": "string",
  "notify_group_members": true,
  "custom_message": "string",
  "author_username": "string"
})

Parameters

topic_idintegerrequired

usernamestring

group_namestring

email_addressstring

notify_group_membersboolean

custom_messagestring

author_usernamestring

Docs by Sourcey