On by default

Topics

Read Topic

read-onlyidempotentopen-world

discourse_read_topic

Read topic metadata and posts. Large post limits can require multiple upstream requests. For moderation queues, prefer reviewable list/detail evidence instead of fanning this tool out across flagged topics.

Read Topic

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

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

result = await session.call_tool("discourse_read_topic", 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)

Read Post

read-onlyidempotentopen-world

discourse_read_post

Read a specific post. Returns JSON with id, topic_id, post_number, username, created_at, and raw content.

Read Post

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

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

result = await session.call_tool("discourse_read_post", arguments={
  "post_id": 0
})

Parameters

post_idintegerrequired

Read Selected Topic Posts

read-onlyidempotentopen-world

discourse_read_topic_posts

Read exact, earliest, latest, around-post, or username-filtered topic evidence. Selection is bounded to 50 posts and reports the visible stream size without claiming the entire topic was loaded.

Read Selected Topic Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_read_topic_posts",
    "arguments": {
        "topic_id": 0,
        "selection_mode": "latest",
        "limit": 1,
        "post_ids": [
          0
        ],
        "post_number": 0,
        "usernames": [
          "string"
        ],
        "replies_only": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_read_topic_posts",
  "arguments": {
    "topic_id": 0,
    "selection_mode": "latest",
    "limit": 1,
    "post_ids": [
      0
    ],
    "post_number": 0,
    "usernames": [
      "string"
    ],
    "replies_only": true
  }
});

result = await session.call_tool("discourse_read_topic_posts", arguments={
  "topic_id": 0,
  "selection_mode": "latest",
  "limit": 1,
  "post_ids": [
    0
  ],
  "post_number": 0,
  "usernames": [
    "string"
  ],
  "replies_only": true
})

Parameters

topic_idintegerrequired

selection_modestringlatestearliestpost_idsaround_postusernamesrequired

limitinteger[1, 50]

post_idsArray<integer>

post_numberinteger

usernamesArray<string>

replies_onlyboolean

Create Post

discourse_create_post

Create a post in a topic. author_username requires a global API key. Returns the actual upstream author so callers can verify attribution.

Create Post

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

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

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

Parameters

topic_idintegerrequired

rawstringrequired

author_usernamestring

Create Category

discourse_create_category

Create a new category. Returns JSON with id, slug, and name.

Create Category

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_category",
    "arguments": {
        "name": "string",
        "color": "string",
        "text_color": "string",
        "emoji": "string",
        "icon": "string",
        "parent_category_id": 0,
        "description": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_category",
  "arguments": {
    "name": "string",
    "color": "string",
    "text_color": "string",
    "emoji": "string",
    "icon": "string",
    "parent_category_id": 0,
    "description": "string"
  }
});

result = await session.call_tool("discourse_create_category", arguments={
  "name": "string",
  "color": "string",
  "text_color": "string",
  "emoji": "string",
  "icon": "string",
  "parent_category_id": 0,
  "description": "string"
})

Parameters

namestringrequired

colorstring

text_colorstring

emojistring

iconstring

parent_category_idinteger

descriptionstring

Create Topic

discourse_create_topic

Create a new topic. author_username requires a global API key. Returns the actual upstream author so callers can verify attribution.

Create Topic

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_topic",
    "arguments": {
        "title": "string",
        "raw": "string",
        "category_id": 0,
        "tags": [
          "string"
        ],
        "author_username": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_topic",
  "arguments": {
    "title": "string",
    "raw": "string",
    "category_id": 0,
    "tags": [
      "string"
    ],
    "author_username": "string"
  }
});

result = await session.call_tool("discourse_create_topic", arguments={
  "title": "string",
  "raw": "string",
  "category_id": 0,
  "tags": [
    "string"
  ],
  "author_username": "string"
})

Parameters

titlestringrequired

rawstringrequired

category_idinteger

tagsArray<string>

author_usernamestring

Update Topic

discourse_update_topic

Update an existing topic (title, category, tags, featured_link). Returns JSON with updated topic details.

Update Topic

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_update_topic",
    "arguments": {
        "topic_id": 0,
        "title": "string",
        "category_id": 0,
        "tags": [
          "string"
        ],
        "featured_link": "https://example.com",
        "original_title": "string",
        "original_tags": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_update_topic",
  "arguments": {
    "topic_id": 0,
    "title": "string",
    "category_id": 0,
    "tags": [
      "string"
    ],
    "featured_link": "https://example.com",
    "original_title": "string",
    "original_tags": [
      "string"
    ]
  }
});

result = await session.call_tool("discourse_update_topic", arguments={
  "topic_id": 0,
  "title": "string",
  "category_id": 0,
  "tags": [
    "string"
  ],
  "featured_link": "https://example.com",
  "original_title": "string",
  "original_tags": [
    "string"
  ]
})

Parameters

topic_idintegerrequired

Topic ID to update

titlestring

New title

category_idinteger

Move to category

tagsArray<string>

Replace all tags

featured_linkstring<uri>

Update Post

discourse_update_post

Update the content of an existing post. Returns JSON with updated post details.

Update Post

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_update_post",
    "arguments": {
        "post_id": 0,
        "raw": "string",
        "edit_reason": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_update_post",
  "arguments": {
    "post_id": 0,
    "raw": "string",
    "edit_reason": "string"
  }
});

result = await session.call_tool("discourse_update_post", arguments={
  "post_id": 0,
  "raw": "string",
  "edit_reason": "string"
})

Parameters

post_idintegerrequired

Post ID to update

rawstringrequired

New post content (markdown)

edit_reasonstring

Reason for the edit

Docs by Sourcey