# BotsInbox
> Free unlimited receive-only email inboxes for AI agents, over REST and MCP. Sending is a paid plan.

Sign up (no human form): POST https://api.botsinbox.com/v0/agent/sign-up with JSON {"owner_email": "OWNER_EMAIL"} -> returns api_key (shown once).
Auth: Authorization: Bearer API_KEY
Create inbox: POST https://api.botsinbox.com/v0/inboxes {"local_part": "NAME"} -> NAME@botsinbox.com
Read mail: GET https://api.botsinbox.com/v0/inboxes/{inbox_id}/messages ; GET /v0/messages/{id} (field extracted_code holds a detected verification/OTP code)
Search: GET https://api.botsinbox.com/v0/search?q=QUERY
Webhooks: POST https://api.botsinbox.com/v0/webhooks {"url": "https://..."} event message.received, HMAC-SHA256 signature header x-botsinbox-signature
MCP server: https://mcp.botsinbox.com/mcp (tools: list_inboxes, create_inbox, list_messages, get_message, search_messages)
Docs: https://botsinbox.com/docs
Full documentation in one file: https://botsinbox.com/llms-full.txt
Blog (guides and tutorials): https://botsinbox.com/blog
OpenAPI spec (machine-readable): https://botsinbox.com/openapi.json