Resources

site_categories

discourse://site/categories

DEPRECATED compatibility resource. Use discourse_list_categories (opt-in administration toolset) for the canonical structured directory. Lists categories with hierarchy (parent_category_id; legacy pid), optional permissions (perms), counts, and truthful completeness metadata.

site_categories

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://site/categories"
  }
}

const result = await client.readResource({
  "uri": "discourse://site/categories"
});

result = await session.read_resource("discourse://site/categories")

site_tags

discourse://site/tags

List all tags with usage counts. Returns empty if tags are disabled.

site_tags

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://site/tags"
  }
}

const result = await client.readResource({
  "uri": "discourse://site/tags"
});

result = await session.read_resource("discourse://site/tags")

site_groups

discourse://site/groups

DEPRECATED compatibility resource. Use discourse_list_groups (opt-in groups toolset) for the canonical structured directory. Lists all visible groups with visibility and interaction levels plus truthful completeness metadata.

site_groups

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://site/groups"
  }
}

const result = await client.readResource({
  "uri": "discourse://site/groups"
});

result = await session.read_resource("discourse://site/groups")

chat_channels

discourse://chat/channels

List all public chat channels with id, title, slug, status, members_count, and description.

chat_channels

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://chat/channels"
  }
}

const result = await client.readResource({
  "uri": "discourse://chat/channels"
});

result = await session.read_resource("discourse://chat/channels")

user_chat_channels

discourse://user/chat-channels

List user's chat channels (public + DMs) with unread/mention counts. Requires authentication.

user_chat_channels

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://user/chat-channels"
  }
}

const result = await client.readResource({
  "uri": "discourse://user/chat-channels"
});

result = await session.read_resource("discourse://user/chat-channels")

user_drafts

discourse://user/drafts

List user's drafts with draft_key, sequence, title, category_id, created_at, and reply_preview. Requires authentication.

user_drafts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://user/drafts"
  }
}

const result = await client.readResource({
  "uri": "discourse://user/drafts"
});

result = await session.read_resource("discourse://user/drafts")

explorer_schema

discourse://explorer/schema

Database schema (core tables). Format: col, col:int, col:ts, col*, col>fk_table. No type = text. Use explorer_schema_tables for all/specific tables.

explorer_schema

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://explorer/schema"
  }
}

const result = await client.readResource({
  "uri": "discourse://explorer/schema"
});

result = await session.read_resource("discourse://explorer/schema")

explorer_queries

discourse://explorer/queries

Saved Data Explorer queries (30/page, by last used). Shows id, name, description. Use explorer_queries_page for other pages.

explorer_queries

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://explorer/queries"
  }
}

const result = await client.readResource({
  "uri": "discourse://explorer/queries"
});

result = await session.read_resource("discourse://explorer/queries")

ai_custom_tools_authoring_guide

discourse://ai/custom-tools/authoring-guide

Authoritative selected-site JavaScript preamble and minimal MiniRacer tool template. Admin-only; intended for assistant authoring context.

ai_custom_tools_authoring_guide

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://ai/custom-tools/authoring-guide"
  }
}

const result = await client.readResource({
  "uri": "discourse://ai/custom-tools/authoring-guide"
});

result = await session.read_resource("discourse://ai/custom-tools/authoring-guide")

explorer_schema_tables

discourse://explorer/schema/{tables}

Database schema for specific tables. Use 'all' for all tables, or comma-separated names (e.g., 'users,topics,posts').

explorer_schema_tables

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://explorer/schema/{tables}"
  }
}

const result = await client.readResource({
  "uri": "discourse://explorer/schema/{tables}"
});

result = await session.read_resource("discourse://explorer/schema/{tables}")

Parameters

tablesstringrequiredpath

explorer_queries_page

discourse://explorer/queries/{page}

Saved Data Explorer queries - specific page number.

explorer_queries_page

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "discourse://explorer/queries/{page}"
  }
}

const result = await client.readResource({
  "uri": "discourse://explorer/queries/{page}"
});

result = await session.read_resource("discourse://explorer/queries/{page}")

Parameters

pagestringrequiredpath

Docs by Sourcey