On by default

Users

Get User

read-onlyidempotentopen-world

discourse_get_user

Get user info. Returns JSON with id, username, name, trust_level, created_at, bio, admin, and moderator.

Get User

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

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

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

Parameters

usernamestringrequired

List User Posts

read-onlyidempotentopen-world

discourse_list_user_posts

Get paginated list of user posts/replies. Returns JSON object with posts array (id, topic_id, post_number, slug, title, created_at, excerpt, category_id) and meta (page, limit, has_more).

List User Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_user_posts",
    "arguments": {
        "username": "string",
        "page": 0,
        "limit": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_user_posts",
  "arguments": {
    "username": "string",
    "page": 0,
    "limit": 1
  }
});

result = await session.call_tool("discourse_list_user_posts", arguments={
  "username": "string",
  "page": 0,
  "limit": 1
})

Parameters

usernamestringrequired

pageinteger>= 0

limitinteger[1, 50]

Posts per page (max 50, default 30)

List Users

read-onlyidempotentopen-world

discourse_list_users

List users via admin API. Requires admin API key. Returns ~100 users per page (Discourse's fixed page size). Returns JSON with users array and pagination meta.

List Users

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_users",
    "arguments": {
        "query": "active",
        "filter": "string",
        "order": "created",
        "asc": false,
        "page": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_users",
  "arguments": {
    "query": "active",
    "filter": "string",
    "order": "created",
    "asc": false,
    "page": 0
  }
});

result = await session.call_tool("discourse_list_users", arguments={
  "query": "active",
  "filter": "string",
  "order": "created",
  "asc": false,
  "page": 0
})

Parameters

querystringactivenewstaffsuspendedsilencedpendingstagedactive

User query type

filterstring

Search by username, email, or IP address

orderstringcreatedlast_emailedseenusernametrust_leveldays_visitedposts

Sort order field

ascbooleanfalse

Sort ascending (default: false/descending)

pageinteger>= 0

Page number (0-indexed)

Create User

discourse_create_user

Create a user through Discourse's signup API using a global admin API key. Reports whether upstream confirmed creation; anti-enumeration responses without user_id remain indeterminate. Optional avatar assignment runs only after confirmed creation.

Create User

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_user",
    "arguments": {
        "username": "string",
        "email": "user@example.com",
        "name": "string",
        "password": "string",
        "active": true,
        "approved": true,
        "upload_id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_user",
  "arguments": {
    "username": "string",
    "email": "user@example.com",
    "name": "string",
    "password": "string",
    "active": true,
    "approved": true,
    "upload_id": 0
  }
});

result = await session.call_tool("discourse_create_user", arguments={
  "username": "string",
  "email": "user@example.com",
  "name": "string",
  "password": "string",
  "active": true,
  "approved": true,
  "upload_id": 0
})

Parameters

usernamestringrequired

emailstring<email>required

namestringrequired

passwordstringrequired

activebooleantrue

approvedbooleantrue

upload_idinteger

Avatar upload_id (from discourse_upload_file)

Update User

discourse_update_user

Update user profile fields. If upload_id is provided, also sets the user's avatar. Returns JSON with success status and updated user details.

Update User

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_update_user",
    "arguments": {
        "username": "string",
        "name": "string",
        "bio_raw": "string",
        "location": "string",
        "website": "https://example.com",
        "title": "string",
        "date_of_birth": "string",
        "locale": "string",
        "profile_background_upload_url": "string",
        "card_background_upload_url": "string",
        "upload_id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_update_user",
  "arguments": {
    "username": "string",
    "name": "string",
    "bio_raw": "string",
    "location": "string",
    "website": "https://example.com",
    "title": "string",
    "date_of_birth": "string",
    "locale": "string",
    "profile_background_upload_url": "string",
    "card_background_upload_url": "string",
    "upload_id": 0
  }
});

result = await session.call_tool("discourse_update_user", arguments={
  "username": "string",
  "name": "string",
  "bio_raw": "string",
  "location": "string",
  "website": "https://example.com",
  "title": "string",
  "date_of_birth": "string",
  "locale": "string",
  "profile_background_upload_url": "string",
  "card_background_upload_url": "string",
  "upload_id": 0
})

Parameters

usernamestringrequired

Username of user to update

namestring

Display name

bio_rawstring

Bio in markdown

locationstring

Location

websitestring<uri>

Website URL

titlestring

User title

date_of_birthstring

Date of birth (YYYY-MM-DD)

localestring

Language preference

profile_background_upload_urlstring

Profile background image URL

card_background_upload_urlstring

Card background image URL

upload_idinteger

Avatar upload_id (from discourse_upload_file)

Docs by Sourcey