Administration - Discourse API

List Categories

read-onlyidempotentopen-world

discourse_list_categories

Exhaustively list categories visible to the selected identity through bounded pagination. Returns stable IDs, slugs, hierarchy (parent_category_id; pid is a legacy alias), access flags, counts, structured completion metadata, and JSON text fallback. Opt in with the administration toolset.

List Categories

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_categories",
    "arguments": {
        "term": "string",
        "max_pages": 1,
        "max_requests": 1,
        "max_results": 1,
        "deadline_ms": 100
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_categories",
  "arguments": {
    "term": "string",
    "max_pages": 1,
    "max_requests": 1,
    "max_results": 1,
    "deadline_ms": 100
  }
});

result = await session.call_tool("discourse_list_categories", arguments={
  "term": "string",
  "max_pages": 1,
  "max_requests": 1,
  "max_results": 1,
  "deadline_ms": 100
})

Response

{
  "categories": [
    {
      "id": 0,
      "name": "string",
      "slug": "string",
      "pid": 0,
      "parent_category_id": 0,
      "read_restricted": true,
      "topic_count": 0,
      "post_count": 0,
      "perms": [
        {
          "gid": 0,
          "perm": 0
        }
      ]
    }
  ],
  "meta": {
    "total": 0,
    "reported_total": 0,
    "pages_fetched": 0,
    "complete": true,
    "has_more": true,
    "truncated_reason": "page_limit",
    "error": "string"
  }
}

List Site Settings

read-onlyidempotentopen-world

discourse_list_site_settings

List admin-visible Discourse site settings with bounded metadata, optionally returning only settings whose current value differs from the default. Secret and credential-like values are always masked.

List Site Settings

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_site_settings",
    "arguments": {
        "categories": [
          "string"
        ],
        "plugin": "string",
        "names": [
          "string"
        ],
        "overridden_only": true,
        "offset": 0,
        "limit": 1
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_site_settings",
  "arguments": {
    "categories": [
      "string"
    ],
    "plugin": "string",
    "names": [
      "string"
    ],
    "overridden_only": true,
    "offset": 0,
    "limit": 1
  }
});

result = await session.call_tool("discourse_list_site_settings", arguments={
  "categories": [
    "string"
  ],
  "plugin": "string",
  "names": [
    "string"
  ],
  "overridden_only": true,
  "offset": 0,
  "limit": 1
})

Parameters

categoriesArray<string>

pluginstring

namesArray<string>

overridden_onlyboolean

offsetinteger>= 0

limitinteger[1, 500]

Manage User Activation

destructiveidempotentopen-world

discourse_manage_user_activation

Activate, approve, activate-and-approve, or deactivate one user through Discourse's authoritative admin routes. Requires explicit confirmation and upstream staff authorization.

Manage User Activation

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_manage_user_activation",
    "arguments": {
        "username": "string",
        "action": "activate",
        "confirm": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_manage_user_activation",
  "arguments": {
    "username": "string",
    "action": "activate",
    "confirm": true
  }
});

result = await session.call_tool("discourse_manage_user_activation", arguments={
  "username": "string",
  "action": "activate",
  "confirm": true
})

Parameters

usernamestringrequired

actionstringactivateapproveactivate_and_approvedeactivaterequired

confirmbooleanrequired

Must be true because this changes account access state