What is mod-agent-for-discord-?

ModAgent is a self-hosted Discord bot that helps moderators keep their community safe by reading messages with the help of AI language models instead of just matching keywords. Regular auto-moderators often flag words like "kill" even when someone is just talking about a video game, because they cannot tell the difference between a joke and a real threat. ModAgent tries to understand the context of a conversation, including sarcasm and gaming banter, before deciding whether something needs attention. Importantly, the bot never bans, mutes, or deletes anything on its own. It only flags suspicious messages and posts a report with a recommendation in a private staff channel, leaving the final decision to human moderators. This human-in-the-loop approach is meant to avoid the frustration and false positives that come from bots taking automatic action. To keep costs low, ModAgent works in stages. First, a free regex filter checks for obvious red flags like scam links or spam. Only messages that pass this filter get sent to a cheap AI model for a first classification. If that model flags something as serious, a stronger and more expensive AI model reviews the full context before writing up a recommendation. A daily spending cap makes sure the bot never runs up a large bill, and if the budget runs out, it falls back to the free regex filtering so the server stays protected. Beyond moderation, ModAgent can answer member questions using a FAQ as its source of truth, welcome new members with short personalized messages, and send a daily summary to staff covering activity, flags, and how much was spent on AI calls that day. It can connect to several different AI providers, including OpenAI-compatible services, self-hosted models, or the Anthropic Claude API, so server owners can choose what fits their budget. Setup involves creating a Discord application, configuring a few settings like the staff channel, and running the bot with Node.js or Docker. The project is released under the MIT license, meaning it can be used and modified freely.