de en es ja ko ru zh

AgentBox

Name: AgentBox
Author: RABNEER

by RABNEER

Overview Schema Source Related Servers Discussions Admin

Rust

Hybrid

⚡ AgentBox

La capa de correo e identidad para agentes de IA

AgentBox le da a cualquier agente de IA autónomo (Claude Code, Cursor, Antigravity, OpenAI Swarm) su propia identidad de correo nativa de máquina, bandeja de entrada, comunicación saliente, autenticación y capacidades de correo impulsadas por eventos: autoalojado, soberano y extremadamente rápido.

Inicio rápido • Abstracción central • Identidad y seguridad del agente • Casos de uso versátiles • Puntos de referencia de rendimiento reproducibles • Referencia de herramientas MCP • Arquitectura

💡 El problema central

Los agentes de IA autónomos necesitan una forma de interactuar con el mundo humano y entre sí. Hoy, el correo electrónico es el protocolo de comunicación universal en todo el software y las plataformas:

¿Cómo verifica un agente de navegador su cuenta en GitHub o AWS? Correo electrónico.
¿Cómo contacta un cliente con tu asistente de soporte de IA? Correo electrónico.
¿Cómo delega un agente de QA externo un informe de error a un agente de codificación? Correo electrónico.
¿Cómo recibe un agente de investigación resúmenes de arXiv y alertas de la industria? Correo electrónico.

Sin una infraestructura de correo nativa de máquina, los desarrolladores se ven obligados a usar sondeos de API frágiles, hackear bandejas de entrada personales de Gmail o hacer clic manualmente en enlaces de verificación.

AgentBox resuelve esto por completo.

                    ┌─────────────────────────┐
                    │        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 Agent

Related MCP server: Mailgent MCP Server

🧑🚀 Modelo de identidad y seguridad del agente

AgentBox no prescribe quién es tu agente. Tú defines el nombre, el correo electrónico y la política de capacidades del agente:

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

🔐 Aplicación de seguridad de múltiples niveles:

Autenticación por token: Verifica la identidad y el estado del agente (active vs revoked).
Ámbitos de capacidad: Valida los permisos requeridos (inbox.read, email.send, otp.read, task.claim).
Propiedad de buzón a nivel de objeto: El agente A que posee otp.read está estrictamente restringido a sus propios buzones asignados (owner_agent_id). Intentar el acceso entre agentes devuelve un error explícito AccessDenied.
Higiene de credenciales: Las consultas públicas (get_agent_identity, list_agent_identities) usan estructuras sanitizadas que nunca exponen tokens.

🌐 Casos de uso versátiles

AgentBox proporciona la capa de identidad de correo fundamental. Estos son algunos de los flujos de trabajo más potentes construidos sobre ella:

1. 🤖 Delegación de trabajo entre agentes y protocolos de tareas

Un agente externo de QA o descubrimiento (como Jules) envía un correo con un error o solicitud de función. El TaskDetector integrado de AgentBox analiza automáticamente el asunto ([TASK:BUG]), extrae el repositorio, la rama, la prioridad y las citas de línea, aprovisiona un AgentTask y despierta al agente de codificación a través del bus de eventos:

   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 ticket

2. 🔐 Registros autónomos en SaaS y verificación 2FA / OTP

Los agentes de navegador (Puppeteer, Playwright, Stagehand) necesitan registrarse en herramientas, verificar direcciones de correo y resolver desafíos OTP:

El agente crea un buzón create_agent_inbox(name: "signup-bot").
Activa el registro en la plataforma (p. ej., AWS, Stripe, Vercel).
Llama a get_latest_otp() (extraído mediante regex en <0.14ms) o get_verification_link() (verificado con defensa anti-redirección y phishing).
La cuenta se verifica de forma autónoma sin intervención humana.

3. 💬 Soporte entrante autónomo y triaje de clientes

Dale a tu agente de soporte al cliente su propia dirección de correo (support@yourcompany.com):

El cliente envía un correo a soporte con un problema.
AgentBox ingiere el correo mediante SMTP sin procesar o sincronización IMAP.
Un evento SSE en tiempo real notifica al agente de soporte.
El agente analiza la consulta, consulta la documentación interna y responde mediante send_agent_email().

4. 🔬 Investigación y recopilación de inteligencia

Dale a tu agente de investigación una identidad (researcher@yourcompany.com):

Se suscribe a boletines de la industria, avisos de seguridad (CVE) y fuentes de resúmenes de arXiv.
El agente lee los correos entrantes periódicamente usando read_agent_inbox().
Sintetiza informes ejecutivos, resume hallazgos y reenvía resúmenes a tu equipo.

5. 🛡️ Alertas de DevOps y respuesta automatizada a incidentes

Dale a tu agente de respuesta a incidentes una identidad (oncall@yourcompany.com):

Recibe alertas de errores críticos de Datadog, Sentry o PagerDuty.
El enlace de eventos en tiempo real despierta al agente inmediatamente.
El agente consulta los registros, identifica el commit que falla y envía una orden de corrección al agente de codificación.

📊 Puntos de referencia de rendimiento reproducibles

AgentBox incluye un conjunto completo de pruebas de referencia (tests/benchmark.rs) que mide todo el pipeline desde bytes sin procesar hasta la salida JSON-RPC completa:

cargo test --release --test benchmark -- --nocapture

⚡ Pipeline MCP completo de extremo a extremo verificado (1,000 ciclos):

Pipeline probado: Raw MIME Ingestion ➔ mail-parser ➔ SafeLink Analysis ➔ Regex OTP ➔ SQLite INSERT ➔ Broadcast Dispatch ➔ Authenticated MCP Tool Call (tools/call) ➔ JSON-RPC Result Output

Métrica del pipeline	Latencia medida	Rendimiento
Promedio (media)	`451.9 µs` (0.451 ms)	2,213 ciclos MCP completos/seg
Mediana p50	`431.5 µs` (0.431 ms)	—
p95	`586.2 µs` (0.586 ms)	—
p99	`1.04 ms`	—

⚡ Latencias de subcomponentes en microsegundos (10,000 iteraciones):

Despacho de canal del bus de eventos: 0.216 µs (0.0002 ms) — 4.62 millones de eventos/seg
Seguridad de enlaces y anti-redirección: 0.652 µs (0.0007 ms) — 1.53 millones de comprobaciones/seg
Extracción de OTP por regex: 138.2 µs (0.138 ms) — 7,230 extracciones/seg

🛠️ Referencia de herramientas MCP

AgentBox implementa la especificación del Model Context Protocol (MCP) sobre stdio:

Categoría	Herramienta	Parámetros	Descripción
Identidad	`create_agent_identity`	`name, email?, capabilities?`	Crea una identidad persistente con correo personalizado/automático y devuelve un token de autenticación de un solo uso.
Identidad	`get_agent_identity`	`agent_id`	Recupera metadatos públicos del agente (los tokens están sanitizados).
Identidad	`list_agent_identities`	—	Lista todas las identidades públicas de agentes registradas y las políticas activas.
Identidad	`revoke_agent_identity`	`agent_id`	Revoca una identidad de agente e invalida su token de autenticación inmediatamente.
Buzón	`create_agent_inbox`	`name, address?, agent_token?`	Crea un nuevo buzón virtual vinculado a la identidad del agente que llama.
Buzón	`get_latest_otp`	`account_id, agent_token?`	Extrae el código de verificación más reciente de 4 a 8 dígitos en <0.14ms con verificación de propiedad.
Buzón	`wait_for_email`	`account_id, timeout_secs?, agent_token?`	Gancho basado en eventos: El canal de difusión asíncrono de Tokio despierta al agente en <0.001ms.
Buzón	`get_verification_link`	`account_id, agent_token?`	Devuelve enlaces de activación analizados con seguridad de enlaces profundos y defensa anti-redirección.
Buzón	`read_agent_inbox`	`account_id, limit?, agent_token?`	Recupera mensajes recientes, texto completo del cuerpo, HTML y metadatos del remitente.
Buzón	`send_agent_email`	`account_id, to, subject, body, agent_token?`	Envía correos salientes mediante relay SMTP con autorización de capacidades.
Buzón	`delete_agent_inbox`	`account_id, agent_token?`	Elimina un buzón temporal y purga los mensajes almacenados.
Protocolo de tareas	`dispatch_agent_task`	`action, description, repository?, branch?, priority?, target_agent?, evidence?, acceptance_criteria?, agent_token?`	Envía una orden de trabajo estructurada de un agente a otro.
Protocolo de tareas	`claim_agent_task`	`task_id, agent_token`	Bloquea y asigna atómicamente una tarea al agente trabajador que la reclama.
Protocolo de tareas	`update_task_progress`	`task_id, status, commit_sha?, pr_url?, test_results?, note?, agent_token`	Actualiza el estado de la tarea (`running`, `testing`, `pr_opened`) y registra el registro de auditoría.
Protocolo de tareas	`complete_agent_task`	`task_id, summary, commit_sha?, pr_url?, test_results?, agent_token`	Cierra una tarea con detalles de finalización y emite un evento de finalización.
Protocolo de tareas	`list_agent_tasks`	`status?, agent_token?, limit?`	Lista tareas filtradas por estado del ciclo de vida o identidad del agente.
Protocolo de tareas	`get_task_audit_trail`	`task_id, agent_token?`	Recupera el registro de auditoría inmutable y el historial del ciclo de vida de una tarea.

🚀 Inicio rápido

1. CLI NPM sin interfaz (configuración cero)

Configura automáticamente tus herramientas de IA al instante en 1 segundo:

# 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 ui

2. Aplicación de escritorio nativa en Electron

# Clone the repository
git clone https://github.com/RABNEER/AgentBox.git
cd AgentBox

# Install dependencies and start Desktop App
npm install
npm run app

3. Daemon central de Rust de alta velocidad

# 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

🏗️ Arquitectura

                                  ┌───────────────────────────┐
                                  │   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     │      │                       │
     └───────────────────────┘      └───────────────────────┘      └───────────────────────┘

📄 Licencia

Distribuido bajo la Licencia MIT. Consulta LICENSE para más información.

Construido con 🖤 por RABNEER y la Comunidad de Código Abierto de AgentBox

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

CryptoAgentMail
io.github.influqa
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Email Communication
21
email A
dev.primitive
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email Communication
142
AgentMailOAuth
to.agentmail
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Email Communication
2
AgenticEmail A
dev.agenticemail
Hosted email for AI agents: create inboxes, send, receive, and reply over MCP with scoped API keys
Email Communication
2

Related MCP Servers

UnCorreoTemporal
Autonomous Agents App Automation
francofuji
A
license
B
quality
C
maintenance
Disposable 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.
Updated 6 months ago (2026-04-19 00:24 UTC)
6
MIT
Mailgent MCP Server
Email Security App Automation
loomal-ai
A
license
Not graded
quality
F
maintenance
Provides 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.
Updated 4 months ago (2026-06-06 10:26 UTC)
9 npm
MIT
Shoot Email
powersurge01
A
license
Not graded
quality
B
maintenance
An 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.
Updated 2 months ago (2026-07-30 18:14 UTC)
MIT
smails
Email Communication
pexni
A
license
Not graded
quality
D
maintenance
Disposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.
Updated 4 months ago (2026-06-26 11:48 UTC)
37
MIT