parlor

A Discourse forum management tool built with Sigil. Works as both a CLI for humans and an MCP server for AI agents.

CLI Usage

parlor topics latest                          # List latest topics
parlor topics top                             # List top topics
parlor topics get 42                          # Get topic
parlor topics create "Title" "Body" 5         # Create topic in category 5
parlor topics close 42                        # Close topic
parlor topics open 42                         # Reopen topic
parlor topics pin 42                          # Pin topic
parlor topics delete 42                       # Delete topic
parlor topics invite 42 "user@example.com"    # Invite user to topic
parlor posts get 123                          # Get post
parlor posts create 42 "Reply body"           # Reply to topic
parlor posts update 123 "Edited body"         # Edit post
parlor posts delete 123                       # Delete post
parlor messages send "Subject" "Body" "user"  # Send message
parlor messages list username                 # List messages
parlor search "query string"                  # Search forum
parlor categories list                        # List categories
parlor categories get 5                       # Get category
parlor categories create "Name" "0088CC"      # Create category
parlor users get username                     # Get user
parlor users list                             # List users
parlor users by-email user@example.com        # Find user by email
parlor users create "Name" "e@x.com" "pw" un  # Create user
parlor groups list                            # List groups
parlor groups get group-name                  # Get group
parlor groups create new-group                # Create group

DISCOURSE_URL=https://forum.example.com
DISCOURSE_API_KEY=your-api-key-here
DISCOURSE_USERNAME=system

sigil deps install
sigil build