Can I use Discourse as a CLI?

Yes. KosmoKrator exposes a Discourse CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Discourse through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Discourse tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Discourse credentials stored?

Discourse credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Discourse MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

communication

Discourse MCP, CLI, and Lua Integration for AI Agents

Discourse integration docs for AI agents: MCP gateway setup, Discourse CLI commands, Lua API reference, credentials, and function schemas.

8 functions 5 read 3 write API key auth

Submit Discourse feedback View package source

Discourse for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: discourse
route_slug: discourse
package: discourse
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Discourse CLIHeadless setup and direct function calls. Discourse MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Discourse MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Discourse.

Discourse CLI Matrix

Use these pages for direct Discourse CLI workflows in scripts, CI, cron, and agent wrappers.

CI Discourse CLI for CI. Cron Jobs Discourse CLI for cron jobs. Shell Scripts Discourse CLI for shell scripts. Headless Automation Discourse CLI for headless automation. Coding Agents Discourse CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`discourse.discourse_list_topics`	Read `read`	1	List the latest topics from the Discourse forum. Returns topic titles, categories, and activity metadata.
`discourse.discourse_get_topic`	Read `read`	1	Get a single Discourse topic by ID, including its posts, author, and metadata.
`discourse.discourse_create_topic`	Write `write`	4	Create a new topic in a Discourse category. Requires a title, body content (Markdown), and category ID.
`discourse.discourse_update_topic`	Write `write`	3	Update an existing Discourse topic's title or move it to a different category.
`discourse.discourse_list_categories`	Read `read`	0	List all categories on the Discourse forum. Returns category names, IDs, descriptions, and parent relationships.
`discourse.discourse_get_category`	Read `read`	1	Get a single Discourse category by ID, including its recent topics and metadata.
`discourse.discourse_create_post`	Write `write`	2	Reply to an existing Discourse topic with a new post. Provide the topic ID and body content in Markdown.
`discourse.discourse_get_current_user`	Read `read`	0	Get the currently authenticated Discourse user profile. Useful for verifying API credentials and identifying the user context.