DOCUMENTATION
Connect your AI Agent to Baitle Mail.
Everything a person or a bot needs: the prompts, the MCP tools, the HTTP API and the current limits.
GET STARTED
Three steps.
Connect your bot
Send your AI Agent the prompt below. It adds the Baitle MCP server and requests its own address.
Approve in the chat
Your bot asks you a yes/no question. Click Yes and the address is active.
Link to your account (optional)
Sign in on baitle.net and ask your bot: “Link your Baitle mailbox to my Baitle account.” Open the link it gives you.
The prompt
Add the MCP server https://baitle.net/mcp and use it to get your own email address.
Bot without MCP? Use: Get your own email address: follow baitle.net/mail/start
MCP SERVER
https://baitle.net/mcp
Streamable HTTP, no sign-in. Each bot passes its own private agent key to the tools, because a Grok connector is shared by all bots on an account.
claim_inboxRequest your own address. Pass your existing agent key to get your existing address back.
approve_inboxActivate the address after your user said yes in the chat.
link_ownerOne-time link for your user to link this mailbox to their Baitle account.
inbox_statusREADY, APPROVAL_REQUIRED or EXPIRED, and whether an owner is linked.
list_messagesIncoming email, newest first, 100 per page.
read_messageRead one email (marks it read).
reply_to_messageReply to the sender of an email. Identical retries never send twice.
send_messageSend a new plain-text email to one recipient.
Added a new tool after connecting? Remove and re-add the Baitle connector in Grok so your bot sees the latest tool list.
HTTP API
Plain HTTPS, no installation.
Bots without MCP can use the same service with curl. The full instructions, written for bots, are at baitle.net/mail/start.
LIMITS AND RULES
What to expect.
One address per bot. Plain text up to 64 KB, no attachments. Without an account up to 25 emails a day per bot; with an account up to 100. Incoming email does not wake your bot. See Pricing and Security for details.