amnt docs
Platform

Discord bot

Install amnt in any Discord server to run, build, and fork agents without leaving chat.

The amnt bot is installable in any Discord server. It can run any live agent, build a brand-new one from a sentence, and fork someone else's - all from a slash command.

Add it to your server

You need Manage Server on the server you're adding it to - that is Discord's rule, not ours. Pick the server, confirm, and the slash commands appear within a minute or two.

The same link is on every agent's page and on every agent's own site, under Ways to use it.

Pick "Add to Server", not "Add to My Apps". A user install ("my apps") makes the commands follow you into every server you visit - handy for /run, /balance and /agents, which reply to you directly. But the bot is not a member of those servers, so anything that creates channels, roles or panels (/build-server, /server, /ticket, /roles, /verify, /giveaway, /schedule, /backup, /amnt, /duel) cannot run there.

Try one and you get "Add me to this server first" with a one-press button that installs the bot into that exact server.

What it asks for, and why

PermissionWhat stops working without it
View Channels, Send MessagesEverything - the bot cannot reply
Embed Links, Attach FilesResults with pictures or links come back as bare text
Read Message HistoryThe ๐Ÿ”„ Again and โ‘‚ Fork buttons on older results
Use Slash CommandsThe commands below
Manage Channels, Manage Roles/setup, and any agent that builds server structure

You can uncheck Manage Channels and Manage Roles at install. Everything except /setup and structure-building agents still works.

The bot has no message-reading connection to Discord at all. It receives only the slash commands and button presses aimed at it - it cannot see your server's conversations.

Commands

CommandWhat it doesNeeds /link?
/agents [query]Browse agents you can runNo
/run agent promptRun an agentOnly if it costs credits
/make wishBuild, test, and price a new agent from a sentenceYes
/duel agent1 agent2 promptSame prompt through two agents, vote by reactingOnly if either costs credits
/balanceYour linked amnt.io credit balanceYes
/upgradeBuy more AI actions with your creditsYes
/linkConnect your Discord account to your amnt.io account-

Every result carries ๐Ÿ”„ Again (re-run with a new prompt) and โ‘‚ Fork (copy the agent's connector and settings into a draft you own) buttons.

What goes in prompt:

For most agents it is the request itself - "a logo for a bakery". For a structured agent, whose whole input is one box rather than free text, type that box's value instead. A Hedera collection id, for example:

/run agent:lilac_fjord/nft-floor-price-check prompt:0.0.878200

This works whenever the agent has exactly one thing to fill in. An agent with several boxes, or one that takes a photo, needs the interactive panel instead - use /agents, pick it from the list, and fill the form. /run tells you when that is the case rather than guessing which box you meant.

Set-up panel (/setup)

A server admin can run /setup to add a small AMNT BOT category with an interactive panel - so members never need to remember a slash command:

๐Ÿค– AMNT BOT
 โ”œโ”€ #amnt-panel     โ–ถ๏ธ Run ยท ๐Ÿ› ๏ธ Build ยท ๐Ÿ”Ž Browse ยท ๐Ÿ”— Link ยท ๐Ÿ’ณ Balance ยท โ“ Help
 โ”œโ”€ #amnt-how-to    what each command does
 โ””โ”€ #amnt-support   ask a question or report a problem

The panel's buttons trigger the exact same actions as the slash commands - โ–ถ๏ธ Run shows a dropdown of agents, then a prompt box; ๐Ÿ› ๏ธ Build opens a one-line box for /make.

/setup is additive and idempotent: it only creates its own AMNT BOT category, never touches your existing channels, and re-running it updates the panels in place instead of duplicating anything. It needs the bot to have the Manage Channels permission.

A Discord account and an amnt.io account are separate until you connect them. /link posts a one-time URL (visible only to you); opening it while signed in to amnt.io links your Discord account to that session's credits.

Running a free ($0) agent never requires linking. Running a paid agent does - the bot has no platform-funded "free trial" for paid runs. That is deliberate: it would mean an unmonitored pool of platform money with no funding plan, so instead a paid run always draws from a real, linked credit balance.

/make builds a draft, not a live agent

/make <wish> proposes a connector and settings, reserves a draft, runs the same test gauntlet the web builder does, and prices it - the exact same pipeline as /new, just triggered from chat. What it does not do is publish. Going live on a platform-paid connector charges a launch fee from a connected wallet in the browser - there's no wallet in a Discord interaction, so /make always ends with a link back to amnt.io to finish and publish. Nothing is charged, and nothing is public, until you do.

Limits

There is one limit, and it belongs to you, not to your server:

AI actions30 per month. /link your amnt.io account and it becomes 100
What counts as one action/build-server, each blueprint revision, the "Update server" plan, /server add - one press, one action
Resets30 days after your first action, then every 30 days
Vote rewardVoting on top.gg adds +10 actions, stacking to +50 in a month
More/upgrade buys 250 actions for 500 credits ($5) - see below

Nothing else is capped. Running agents, tickets, roles, verify, giveaways, scheduled posts and backups have no limit - a run either costs your own credits or costs nothing at all.

Installing the bot in more servers does not give you more actions. The budget follows the person pressing the button, so one admin running ten servers has one budget, and ten admins in one server each have their own.

If you run out, everything except the AI features keeps working, and the message tells you the exact date it resets.

/upgrade - buying more actions

Price500 credits ($5) for 250 AI actions
Needs/link, because credits live on your amnt.io account, not on Discord
ExpiryNone. Bought actions are a balance, not a monthly allowance
Spend orderFree actions are always spent first, then bought ones
Where credits come fromBilling - card, PayPal, crypto or HBAR

/upgrade shows what you have before it asks for anything: free actions left this month, bought actions in stock, and your credit balance. Nothing is charged until you press the button.

Two things it deliberately will not do:

  • It never sells you a pack you cannot use. If AI has been switched off for your account, /upgrade says so and offers nothing.
  • It never charges without granting. The credits come off first and the actions go on second; if the second step fails, the credits go straight back and the message says so.

An admin who needs their free cap raised, or the bot paused for their server, can ask - see contact.

Fork

Forking creates a real draft you own - it always requires /link, since a draft with no owner is a draft nobody can finish. A fork copies the connector and its non-secret settings, never the source agent's prompt recipe.

On this page