AgentBox
Supports Google (Gmail/Google Workspace) through IMAP TLS polling and SMTP sending, giving AI agents the ability to read, send, and process verification emails in their own mailboxes.
Supports Hostinger email hosting through IMAP TLS polling and SMTP sending, enabling AI agents to receive and respond to email from Hostinger mailboxes.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AgentBoxcheck my inbox for the latest OTP verification code"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚡ AgentBox
The Email & Identity Layer for AI Agents
AgentBox gives any autonomous AI agent (Claude Code, Cursor, Antigravity, OpenAI Swarm) its own machine-native email identity, inbox, outbound communication, authentication, and event-driven email capabilities — self-hosted, sovereign, and blazingly fast.
Quick Start • Core Abstraction • Agent Identity & Security • Use Cases • Benchmarks • MCP Tools • Architecture
💡 The Core Problem
Autonomous AI agents need a way to interact with the human world and each other. Today, email is the universal communication protocol across all software and platforms:
How does a browser agent verify its account on GitHub or AWS? Email.
How does a customer contact your AI support assistant? Email.
How does an external QA agent delegate a bug report to a coding agent? Email.
How does a research agent receive arXiv digests and industry alerts? Email.
Without machine-native email infrastructure, developers are forced to use brittle API polling, hack personal Gmail inboxes, or manually click verification links.
AgentBox solves this entirely.
┌─────────────────────────┐
│ AGENTBOX │
└────────────┬────────────┘
│
┌──────────────────┴──────────────────┐
▼ ▼
🧑🚀 IDENTITY 📬 COMMUNICATION
• User-Defined Name & Email • Inbound Inbox (SMTP/IMAP/HTTP)
• Persistent Agent ID • Outbound SMTP Relay
• Scoped Capability Matrix • Realtime Event Bus (<0.001ms)
• Object-Level Ownership • OTP Isolator & SafeLink Engine
│ │
└──────────────────┬──────────────────┘
│
▼
Autonomous AI AgentRelated MCP server: Mailgent MCP Server
🧑🚀 Agent Identity & Security Model
AgentBox does not prescribe who your agent is. You define the agent's name, email, and capability policy:
# 1. Create a Support Agent with a custom company email
npx agentbox-mail agent create support \
--email support@mycompany.com \
--capabilities "inbox.read,email.send"
# 2. Create an Autonomous Coding Agent
npx agentbox-mail agent create coder \
--email coder@mycompany.com \
--capabilities "inbox.read,task.claim,task.update,otp.read"
# 3. Create a Browser QA Agent with standard verification permissions
npx agentbox-mail agent create browser-qa \
--capabilities "inbox.read,otp.read,links.read"╔══════════════════════════════════════════════════════════════════╗
║ 🧑🚀 AGENT IDENTITY PROVISIONED ║
╠══════════════════════════════════════════════════════════════════╣
║ Agent ID : agent_coder_7f92a1 ║
║ Name : coder ║
║ Email : coder@mycompany.com ║
║ Auth Token : agb_92d7e8f1c3a04b12 ║
║ Capabilities : ["inbox.read", "task.claim", "otp.read"] ║
║ Status : active ║
╚══════════════════════════════════════════════════════════════════╝
⚠️ NOTE: Store this auth_token securely. It is only displayed once upon creation.🔐 Multi-Tier Security Enforcement:
Token Authentication: Verifies agent identity and status (
activevsrevoked).Capability Scopes: Validates required permissions (
inbox.read,email.send,otp.read,task.claim).Object-Level Mailbox Ownership: Agent A possessing
otp.readis strictly restricted to its own assigned mailboxes (owner_agent_id). Attempting cross-agent access returns an explicitAccessDeniederror.Credential Hygiene: Public queries (
get_agent_identity,list_agent_identities) use sanitized structs that never expose tokens.
🌐 Versatile Use Cases
AgentBox provides the foundational email identity layer. Here are some of the most powerful workflows built on top of it:
1. 🤖 Agent-to-Agent Work Delegation & Task Protocols
An external QA or discovery agent (like Jules) sends an email with a bug or feature request. AgentBox's built-in TaskDetector automatically parses the subject ([TASK:BUG]), extracts the repository, branch, priority, and line citations, provisions an AgentTask, and wakes the Coding Agent via the event bus:
Jules (QA Agent)
│
│ 1. Sends email: "[TASK:BUG] Fix duplicate property filter in EstateFlow"
│ Body: "Repository: RABNEER/EstateFlow\nPriority: high\nEvidence: tests/search.spec.ts:87"
▼
┌─────────────────┐
│ AgentBox │ ──► Auto-detects Work Order via `TaskDetector`
└────────┬────────┘ ──► Provisions `AgentTask` & records audit event
│
│ 2. Realtime Event Bus Dispatch (<0.001ms) / SSE Daemon Bridge
▼
Coder (Worker Agent / Claude Code)
│ 3. Instantaneously claims task via `claim_agent_task`
│ 4. Fixes code, opens GitHub PR, calls `update_task_progress`
│ 5. Calls `complete_agent_task` with CI results
▼
┌─────────────────┐
│ AgentBox │ ──► Status: "completed" + Immutable Audit Lineage
└────────┬────────┘
│ 6. Emits completion notification to Jules / User
▼
Jules closes ticket2. 🔐 Autonomous SaaS Signups & 2FA / OTP Verification
Browser agents (Puppeteer, Playwright, Stagehand) need to sign up for tools, verify email addresses, and solve OTP challenges:
Agent creates inbox
create_agent_inbox(name: "signup-bot").Triggers signup on platform (e.g. AWS, Stripe, Vercel).
Calls
get_latest_otp()(extracted via regex in <0.14ms) orget_verification_link()(checked with Anti-Redirect & Phishing Defense).Account is verified autonomously with zero human intervention.
3. 💬 Autonomous Inbound Support & Customer Triage
Give your customer support agent its own email address (support@yourcompany.com):
Customer emails support with an issue.
AgentBox ingests the email via raw SMTP or IMAP sync.
Realtime SSE event notifies the support agent.
Agent analyzes the inquiry, consults internal docs, and replies via
send_agent_email().
4. 🔬 Research & Intelligence Gathering
Give your research agent an identity (researcher@yourcompany.com):
Subscribes to industry newsletters, security advisories (CVEs), and arXiv digest feeds.
Agent reads inbound emails periodically using
read_agent_inbox().Synthesizes executive briefings, summarizes findings, and forwards digests to your team.
5. 🛡️ DevOps Alerting & Automated Incident Response
Give your incident response agent an identity (oncall@yourcompany.com):
Receives critical error alerts from Datadog, Sentry, or PagerDuty.
Realtime event hook wakes the agent immediately.
Agent queries logs, identifies the failing commit, and dispatches a fix order to the coding agent.
📊 Reproducible Performance Benchmarks
AgentBox includes a complete benchmark test suite (tests/benchmark.rs) measuring the entire pipeline from raw bytes to full JSON-RPC output:
cargo test --release --test benchmark -- --nocapture⚡ Verified Full End-to-End MCP Pipeline (1,000 Cycles):
Tested Pipeline: Raw MIME Ingestion ➔ mail-parser ➔ SafeLink Analysis ➔ Regex OTP ➔ SQLite INSERT ➔ Broadcast Dispatch ➔ Authenticated MCP Tool Call (tools/call) ➔ JSON-RPC Result Output
Pipeline Metric | Measured Latency | Throughput |
Average (Mean) |
| 2,213 complete MCP cycles/sec |
p50 Median |
| — |
p95 |
| — |
p99 |
| — |
⚡ Sub-Component Microsecond Latencies (10,000 Iterations):
Event Bus Channel Dispatch:
0.216 µs(0.0002 ms) — 4.62 Million events/secLink Safety & Anti-Redirect:
0.652 µs(0.0007 ms) — 1.53 Million checks/secOTP Regex Extraction:
138.2 µs(0.138 ms) — 7,230 extractions/sec
🛠️ MCP Tools Reference
AgentBox implements the Model Context Protocol (MCP) specification over stdio:
Category | Tool | Parameters | Description |
Identity |
|
| Creates a persistent identity with custom/auto email and returns a one-time auth token. |
Identity |
|
| Retrieves public agent metadata (tokens are sanitized). |
Identity |
| — | Lists all registered public agent identities and active policies. |
Identity |
|
| Revokes an agent identity and invalidates its auth token immediately. |
Mailbox |
|
| Creates a new virtual mailbox linked to the calling agent identity. |
Mailbox |
|
| Extracts the newest 4–8 digit verification code in <0.14ms with ownership check. |
Mailbox |
|
| Event-Driven Hook: Async Tokio broadcast channel wakes the agent in <0.001ms. |
Mailbox |
|
| Returns parsed activation links with Deep Link Safety & Anti-Redirect Defense. |
Mailbox |
|
| Retrieves recent messages, full body text, HTML, and sender metadata. |
Mailbox |
|
| Dispatches outbound emails via SMTP relay with capability authorization. |
Mailbox |
|
| Deletes a temporary mailbox and purges stored messages. |
Task Protocol |
|
| Dispatches a structured work order from one agent to another. |
Task Protocol |
|
| Atomically locks and assigns a task to the claiming worker agent. |
Task Protocol |
|
| Updates task status ( |
Task Protocol |
|
| Closes a task with completion details and emits completion event. |
Task Protocol |
|
| Lists tasks filtered by lifecycle state or agent identity. |
Task Protocol |
|
| Retrieves the immutable audit log and lifecycle history for a task. |
🚀 Quick Start
1. Headless NPM CLI (Zero Setup)
Instantly auto-configure your AI tools in 1 second:
# 1-Click Auto-Install MCP Server & AI Skill into Claude Code, Cursor, Antigravity
npx agentbox-mail init
# Start MCP stdio server with live daemon SSE event bridge
npx agentbox-mail mcp
# Create an Agent Identity with scoped capabilities
npx agentbox-mail agent create support --email support@mycompany.com --capabilities "inbox.read,email.send"
# Retrieve latest OTP code
npx agentbox-mail otp agent@yourdomain.com
# Launch Web Dashboard
npx agentbox-mail ui2. Native Electron Desktop App
# Clone the repository
git clone https://github.com/RABNEER/AgentBox.git
cd AgentBox
# Install dependencies and start Desktop App
npm install
npm run app3. High-Speed Rust Core Daemon
# Build the optimized production binary
cargo build --release
# Start all-in-one daemon (HTTP Port 3000 + SMTP Port 2525)
./target/release/agentbox-mail server --port 3000🏗️ Architecture
┌───────────────────────────┐
│ Inbound Emails & Tasks │
└─────────────┬─────────────┘
│
┌──────────────────────────────┼──────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
│ Hostinger / Titan / │ │ Raw SMTP Listener │ │ Inbound HTTP Webhook │
│ Google IMAP TLS (993) │ │ (0.0.0.0:2525) │ │ (POST /v1/inbound) │
└───────────┬───────────┘ └───────────┬───────────┘ └───────────┬───────────┘
│ │ │
└──────────────────────────────┼──────────────────────────────┘
│
▼
┌─────────────────────────────┐
│ High-Speed Parser Engine │
│ • 4–8 Digit OTP Isolator │
│ • Link Safety Engine │
│ • TaskDetector (Work Order)│
└──────────────┬──────────────┘
│
▼
┌─────────────────────────────┐
│ Embedded SQLite Storage │
│ (`agentbox.db`) │
│ • Identities & Auth Tokens │
│ • Mailboxes & Messages │
│ • Resource Ownership Graph │
│ • Agent Tasks & Audit Logs │
└──────────────┬──────────────┘
│
┌──────────────────────────────┼──────────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────────────┐ ┌───────────────────────┐ ┌───────────────────────┐
│ Realtime SSE Bus │ │ MCP Server (stdio) │ │ Native Desktop App / │
│ (`GET /v1/events`) │ │ Full Tool Interface │ │ Web Dashboard (:3000) │
│ (Live Daemon Bridge) │ │ Object-Level Auth │ │ │
└───────────────────────┘ └───────────────────────┘ └───────────────────────┘📄 License
Distributed under the MIT License. See LICENSE for more information.
Built with 🖤 by RABNEER & The AgentBox Open Source Community
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityCmaintenanceDisposable email MCP server for autonomous AI agents. Create labeled temporary inboxes, wait for verification emails, extract OTP codes and confirmation links — zero human intervention required.6MIT
- AlicenseNot gradedqualityFmaintenanceProvides identity infrastructure for AI agents to manage email communications, including sending, replying, and organizing messages. It also includes a secure vault for managing credentials and generating TOTP codes.22MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides AI agents with a persistent, agent-native email mailbox for sending, receiving, and managing emails through bounded-context retrieval, idempotent operations, and explicit acknowledgement.MIT
- AlicenseAqualityAmaintenanceProvides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.396MIT
Related MCP Connectors
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.
Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/RABNEER/AgentBox'
If you have feedback or need assistance with the MCP directory API, please join our Discord server