MeshBot Commands

MeshBot is the Florida Mesh Discord bot used for MQTT account self-service and mesh troubleshooting commands.

Commands can be sent in a Discord server channel by mentioning @MeshBot first:

After MeshBot has direct messaged you, commands can also be sent directly to the bot without the @MeshBot mention:

You must allow direct messages from server members in Discord if you expect MeshBot to send credentials or command results by DM.

Help

Use help to list available commands. Use --help with a command to show command-specific usage.

Some commands also accept --argument value syntax instead of argument:value syntax.

Basic Commands

ping

Checks whether MeshBot is responding.

info

Shows non-sensitive runtime information for MeshBot, including bot name, version, adapter, Node.js version, and uptime.

where am i

Shows the Discord server and channel MeshBot sees for the current message. In a DM, it reports that the conversation is a DM.

MQTT Account Commands

mqtt.request

Requests a new MQTT account linked to your Discord account. The username argument is required.

MeshBot validates the requested username, creates the account with the default MQTT profile, and DMs the generated credentials.

Common aliases:

• mqtt request
• request mqtt

mqtt.my-account

Shows the MQTT account linked to your Discord account, including username, status, profile, active broker connections, and creation time.

The active connections field shows MQTT clients currently connected with your account when MeshBot can reach the EMQX API. It will show none when no clients are connected, or unavailable if active connection lookup is not available.

Common aliases:

• mqtt my-account
• mqtt account
• my mqtt account

mqtt.rotate

Rotates the password for your MQTT account and DMs the replacement credentials.

This command requires confirmation before MeshBot changes the password. After rotating the password, update every node or service using that MQTT account.

Common aliases:

• mqtt rotate
• rotate mqtt password

Node Troubleshooting Commands

node.logs

Queries MQTT broker logs for a Meshtastic node ID.

Arguments:

• clientid is required. Use an 8-character hexadecimal node ID, optionally prefixed with !, or the unsigned decimal equivalent.
• minutes is optional and defaults to 15.
• limit is optional and defaults to 20. Results are capped at 100.

Common aliases:

• node logs
• show node logs
• logs for node

node.trace

Queries Floodgate message events by sender, receiver, or Floodgate message ID.

Arguments:

• Provide either id, from, or to.
• from and to can be combined to narrow the trace.
• id cannot be combined with from or to.
• Node IDs can be 8-character hexadecimal values, optionally prefixed with !, the unsigned decimal equivalent, or all for broadcast.
• minutes is optional and defaults to 15.
• limit is optional and defaults to 20. Results are capped at 100.

Common aliases:

• node trace
• trace node

Admin-Only Commands

MeshBot also has admin-only commands for MQTT account resets, profile management, bans, and AUTHZ reports. Those commands require a configured Discord admin role and are not public self-service commands.