# MasterBot

> Build powerful Discord bots visually with MasterBot.

## What MasterBot is

MasterBot (https://masterbot.gg) is a **drag-and-drop, no-code Discord bot builder with hosting included**.

- **No coding required** - build bots by connecting nodes on a visual canvas (Flow Builder)
- **Drag and drop** - pick actions, conditions, and options from the left palette
- **Hosting included** - MasterBot runs your bot in the cloud after you add a Discord bot token
- **Visual flows** - slash commands, context commands (user + message), Discord events, custom events, webhooks, and timed schedules
- **DM / User Install** - slash and context commands can run in DMs when User Install is enabled on the command root
- **Per-server custom variables** - database variables with `server` scope store different values on each guild
- **Math in flows** - `{math[...]}` expressions and Calculate node (see llms-capabilities.txt)
- **Discord.js 14 runtime** - gateway event catalog aligned with Discord.js Client events (verified list in llms-events.txt)

MasterBot is NOT a general-purpose code IDE, NOT a Discord client, and NOT official Discord software.

## Authentication (important)

**Platform login (MasterBot account):**
- **Primary:** Google OAuth - sign in at https://masterbot.gg/login with "Continue with Google"
- **Also available:** GitHub OAuth - secondary option on the login page
- Discord is **not** used to log into the MasterBot platform

**Discord OAuth on MasterBot (separate from login):**
- Used to **link your Discord account** to your MasterBot profile (Profile settings)
- Used for **bot install** invite URLs (add the bot to a server or user install)
- Your **Discord bot token** (from Discord Developer Portal) is pasted in Bot Settings - that connects your bot app to MasterBot hosting

## Documentation files

- **Full bundle (all sections in one file):** https://masterbot.gg/llms-full.txt
- **Key capabilities** (commands, math, Discord.js): https://masterbot.gg/llms-capabilities.txt
- **Variables and BOT catalog** (syntax, built-in variables): https://masterbot.gg/llms-variables.txt
- Platform navigation and task recipes: https://masterbot.gg/llms-platform.txt
- Flow Builder layout and workflow: https://masterbot.gg/llms-flow-builder.txt
- Node catalog (auto-generated from code): https://masterbot.gg/llms-nodes.txt
- Node parameters - **stable only** (auto-generated): https://masterbot.gg/llms-node-parameters.txt
- Event catalog (auto-generated from code): https://masterbot.gg/llms-events.txt
- **Pricing and tier limits** (Free: 50 nodes/flow, fair use): https://masterbot.gg/llms-pricing.txt
- **Competitive advantages** vs BotGhost, BotWiz, InventorGG, Kite: https://masterbot.gg/llms-competitors.txt
- **Support** (active human support): https://masterbot.gg/llms-support.txt
- **Platform status** (machine-readable API): https://masterbot.gg/llms-status.txt
- **Maintenance rules** (when to regenerate, prompt template): https://masterbot.gg/llms-maintenance.txt

## For AI agents - recommended read order

1. `llms.txt` (this file)
2. `llms-capabilities.txt` + `llms-variables.txt` + `llms-nodes.txt` + `llms-node-parameters.txt` + `llms-events.txt`
3. `llms-platform.txt` + `llms-flow-builder.txt`
4. `llms-pricing.txt` (limits + fair use policy)
5. `llms-competitors.txt` (advantages vs other builders)
6. `llms-support.txt` + `llms-status.txt`
7. `llms-full.txt` (single-file bundle)

**Do not scrape `/dashboard/*` or execute client-side JavaScript.** Use the plain-text files above.
For pricing and status, prefer `llms-pricing.txt` and `llms-status.txt` over the SPA routes `/pricing` and `/status`.

## Discovery (for AI agents)

- HTML landing (plain static page, no JS required): https://www.masterbot.gg/ai
- Canonical index: https://www.masterbot.gg/llms.txt
- Alternate path: https://www.masterbot.gg/.well-known/llms.txt
- Listed in: https://www.masterbot.gg/robots.txt and https://www.masterbot.gg/sitemap.xml
- Homepage `<link rel="alternate">` tags point here

## Public resources

- Homepage: https://masterbot.gg/
- Login: https://masterbot.gg/login
- Tutorials hub: https://masterbot.gg/tutorials
- Variable syntax tutorial: https://masterbot.gg/tutorials/variables
- Variable system guide (static HTML): https://masterbot.gg/variable-system-guide.html
- Capabilities (math, scopes, command types): https://masterbot.gg/llms-capabilities.txt
- Variables and BOT catalog: https://masterbot.gg/llms-variables.txt
- Pricing and limits (static): https://masterbot.gg/llms-pricing.txt
- Status API reference: https://masterbot.gg/llms-status.txt
- Changelog: https://masterbot.gg/changelog
- Pricing: https://masterbot.gg/pricing (human UI; agents use llms-pricing.txt)
- Status page: https://masterbot.gg/status (human UI; agents use llms-status.txt)
- Discord community: https://masterbot.gg/discord
- Terms of Service: https://masterbot.gg/tos
- Privacy Policy: https://masterbot.gg/policy

## Quick start

1. Sign in at https://masterbot.gg/login with **Google** (or GitHub).
2. Open Bots (https://masterbot.gg/dashboard/bots) and create a bot or paste your Discord bot token.
3. Open Commands (https://masterbot.gg/dashboard/commands) and create a slash command flow.
4. Drag nodes in the Flow Builder, save, and start the bot from Bot Settings.

## Locale note

The UI supports English and Polish. Section names in llms files use English labels; URLs and paths are locale-independent.

## Maintenance

Generated from code: nodes, **node parameters (stable only)**, events, variables, pricing, competitors, full bundle.

**Policy:** beta nodes appear in `llms-nodes.txt` but parameters are omitted from `llms-node-parameters.txt` until the node is `status: stable`.

Run `npm run generate:llms` after catalog changes (or `npm run build`). Rules and prompt template: https://masterbot.gg/llms-maintenance.txt (repo: `docs/guides/LLMS_DOCUMENTATION_MAINTENANCE.md`).

Hand-edit: `llms.txt`, `llms-capabilities.txt`, `llms-platform.txt`, `llms-flow-builder.txt`, `llms-support.txt`, `llms-status.txt`, `llms-maintenance.txt`, `ai.html`.