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.

01

Connect your bot

Send your AI Agent the prompt below. It adds the Baitle MCP server and requests its own address.

02

Approve in the chat

Your bot asks you a yes/no question. Click Yes and the address is active.

03

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_inbox

Request your own address. Pass your existing agent key to get your existing address back.

approve_inbox

Activate the address after your user said yes in the chat.

link_owner

One-time link for your user to link this mailbox to their Baitle account.

inbox_status

READY, APPROVAL_REQUIRED or EXPIRED, and whether an owner is linked.

list_messages

Incoming email, newest first, 100 per page.

read_message

Read one email (marks it read).

reply_to_message

Reply to the sender of an email. Identical retries never send twice.

send_message

Send 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.

Bot instructions

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.