Skip to main content
Glama

⚡ AgentBox

Уровень электронной почты и идентичности для ИИ-агентов

CI npm version npm downloads GitHub Release Rust MCP License: MIT

AgentBox даёт любому автономному ИИ-агенту (Claude Code, Cursor, Antigravity, OpenAI Swarm) собственную машинно-нативную электронную почту, входящие, исходящие сообщения, аутентификацию и управляемые событиями возможности электронной почты — самостоятельно размещаемый, суверенный и молниеносно быстрый.

Быстрый стартОсновная абстракцияИдентичность и безопасность агентаВарианты использованияБенчмаркиСправочник MCP-инструментовАрхитектура


💡 Основная проблема

Автономным ИИ-агентам нужен способ взаимодействия с человеческим миром и друг с другом. Сегодня электронная почта — это универсальный протокол связи для всех программ и платформ:

  • Как браузерный агент подтверждает свою учётную запись на GitHub или AWS? Электронная почта.

  • Как клиент связывается с вашим ИИ-ассистентом поддержки? Электронная почта.

  • Как внешний QA-агент передаёт отчёт об ошибке агенту-кодеру? Электронная почта.

  • Как исследовательский агент получает дайджесты arXiv и отраслевые оповещения? Электронная почта.

Без машинно-нативной почтовой инфраструктуры разработчики вынуждены использовать хрупкий опрос API, взламывать личные почтовые ящики Gmail или вручную нажимать на ссылки подтверждения.

AgentBox решает эту проблему полностью.

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

🧑🚀 Идентичность агента и модель безопасности

AgentBox не предписывает, кто ваш агент. Вы определяете имя агента, адрес электронной почты и политику возможностей:

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

🔐 Многоуровневое обеспечение безопасности:

  1. Аутентификация по токену: Проверяет идентичность и статус агента (active vs revoked).

  2. Области возможностей: Проверяет необходимые разрешения (inbox.read, email.send, otp.read, task.claim).

  3. Владение почтовым ящиком на уровне объекта: Агент A, обладающий otp.read, строго ограничен своими назначенными почтовыми ящиками (owner_agent_id). Попытка доступа к чужому агенту возвращает явную ошибку AccessDenied.

  4. Гигиена учётных данных: Публичные запросы (get_agent_identity, list_agent_identities) используют санитизированные структуры, которые никогда не раскрывают токены.


🌐 Универсальные варианты использования

AgentBox предоставляет базовый уровень идентичности электронной почты. Вот некоторые из самых мощных рабочих процессов, построенных на его основе:

1. 🤖 Делегирование работы между агентами и протоколы задач

Внешний QA- или исследовательский агент (например, Jules) отправляет электронное письмо с ошибкой или запросом функции. Встроенный TaskDetector AgentBox автоматически анализирует тему ([TASK:BUG]), извлекает репозиторий, ветку, приоритет и цитаты строк, создаёт AgentTask и пробуждает агента-кодера через шину событий:

   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. 🔐 Автономная регистрация в SaaS и проверка 2FA / OTP

Браузерные агенты (Puppeteer, Playwright, Stagehand) должны регистрироваться в инструментах, подтверждать адреса электронной почты и решать задачи OTP:

  • Агент создаёт почтовый ящик create_agent_inbox(name: "signup-bot").

  • Запускает регистрацию на платформе (например, AWS, Stripe, Vercel).

  • Вызывает get_latest_otp() (извлекается с помощью регулярного выражения за <0.14ms) или get_verification_link() (проверяется с помощью защиты от перенаправлений и фишинга).

  • Учётная запись подтверждается автономно без участия человека.


3. 💬 Автономная входящая поддержка и сортировка клиентов

Дайте вашему агенту поддержки клиентов собственный адрес электронной почты (support@yourcompany.com):

  • Клиент отправляет письмо в поддержку с проблемой.

  • AgentBox принимает письмо через raw SMTP или IMAP-синхронизацию.

  • Событие Realtime SSE уведомляет агента поддержки.

  • Агент анализирует запрос, обращается к внутренним документам и отвечает через send_agent_email().


4. 🔬 Исследования и сбор информации

Дайте вашему исследовательскому агенту идентичность (researcher@yourcompany.com):

  • Подписывается на отраслевые рассылки, уведомления о безопасности (CVE) и дайджесты arXiv.

  • Агент периодически читает входящие письма с помощью read_agent_inbox().

  • Синтезирует сводки для руководства, обобщает результаты и пересылает дайджесты вашей команде.


5. 🛡️ Оповещения DevOps и автоматическое реагирование на инциденты

Дайте вашему агенту реагирования на инциденты идентичность (oncall@yourcompany.com):

  • Получает критические оповещения об ошибках от Datadog, Sentry или PagerDuty.

  • Хук реального времени немедленно пробуждает агента.

  • Агент запрашивает журналы, определяет сбойный коммит и отправляет заказ на исправление агенту-кодеру.


📊 Воспроизводимые бенчмарки производительности

AgentBox включает полный набор бенчмарк-тестов (tests/benchmark.rs), измеряющих весь конвейер от необработанных байтов до полного вывода JSON-RPC:

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

⚡ Проверенный полный сквозной конвейер MCP (1000 циклов):

Тестируемый конвейер: Raw MIME Ingestion ➔ mail-parser ➔ SafeLink Analysis ➔ Regex OTP ➔ SQLite INSERT ➔ Broadcast Dispatch ➔ Authenticated MCP Tool Call (tools/call) ➔ JSON-RPC Result Output

Метрика конвейера

Измеренная задержка

Пропускная способность

Среднее (среднее)

451.9 µs (0.451 ms)

2,213 полных циклов MCP/сек

p50 Медиана

431.5 µs (0.431 ms)

p95

586.2 µs (0.586 ms)

p99

1.04 ms

⚡ Микросекундные задержки подкомпонентов (10 000 итераций):

  • Диспетчеризация канала шины событий: 0.216 µs (0.0002 ms) — 4.62 миллиона событий/сек

  • Безопасность ссылок и защита от перенаправлений: 0.652 µs (0.0007 ms) — 1.53 миллиона проверок/сек

  • Извлечение OTP с помощью регулярных выражений: 138.2 µs (0.138 ms) — 7,230 извлечений/сек


🛠️ Справочник MCP-инструментов

AgentBox реализует спецификацию Model Context Protocol (MCP) через stdio:

Категория

Инструмент

Параметры

Описание

Идентичность

create_agent_identity

name, email?, capabilities?

Создаёт постоянную идентичность с пользовательской/автоматической почтой и возвращает одноразовый токен аутентификации.

Идентичность

get_agent_identity

agent_id

Получает публичные метаданные агента (токены санитизированы).

Идентичность

list_agent_identities

Перечисляет все зарегистрированные публичные идентичности агентов и активные политики.

Идентичность

revoke_agent_identity

agent_id

Отзывает идентичность агента и немедленно аннулирует его токен аутентификации.

Почтовый ящик

create_agent_inbox

name, address?, agent_token?

Создаёт новый виртуальный почтовый ящик, связанный с идентичностью вызывающего агента.

Почтовый ящик

get_latest_otp

account_id, agent_token?

Извлекает новейший 4–8-значный код подтверждения за <0.14ms с проверкой владения.

Почтовый ящик

wait_for_email

account_id, timeout_secs?, agent_token?

Событийный хук: Асинхронный канал вещания Tokio пробуждает агента за <0.001ms.

Почтовый ящик

get_verification_link

account_id, agent_token?

Возвращает проанализированные ссылки активации с защитой глубоких ссылок и защитой от перенаправлений.

Почтовый ящик

read_agent_inbox

account_id, limit?, agent_token?

Получает последние сообщения, полный текст тела, HTML и метаданные отправителя.

Почтовый ящик

send_agent_email

account_id, to, subject, body, agent_token?

Отправляет исходящие письма через SMTP-релей с авторизацией по возможностям.

Почтовый ящик

delete_agent_inbox

account_id, agent_token?

Удаляет временный почтовый ящик и очищает сохранённые сообщения.

Протокол задач

dispatch_agent_task

action, description, repository?, branch?, priority?, target_agent?, evidence?, acceptance_criteria?, agent_token?

Отправляет структурированный рабочий заказ от одного агента другому.

Протокол задач

claim_agent_task

task_id, agent_token

Атомарно блокирует и назначает задачу агенту-исполнителю, который её запрашивает.

Протокол задач

update_task_progress

task_id, status, commit_sha?, pr_url?, test_results?, note?, agent_token

Обновляет статус задачи (running, testing, pr_opened) и записывает журнал аудита.

Протокол задач

complete_agent_task

task_id, summary, commit_sha?, pr_url?, test_results?, agent_token

Закрывает задачу с деталями завершения и генерирует событие завершения.

Протокол задач

list_agent_tasks

status?, agent_token?, limit?

Перечисляет задачи, отфильтрованные по состоянию жизненного цикла или идентичности агента.

Протокол задач

get_task_audit_trail

task_id, agent_token?

Получает неизменяемый журнал аудита и историю жизненного цикла задачи.


🚀 Быстрый старт

1. Headless NPM CLI (нулевая настройка)

Мгновенно настройте свои ИИ-инструменты за 1 секунду:

# 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. Нативное настольное приложение 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. Высокоскоростной демон ядра на Rust

# 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

🏗️ Архитектура

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

📄 Лицензия

Распространяется под лицензией MIT License. Подробнее см. LICENSE.

Создано с 🖤 RABNEER и сообществом AgentBox Open Source Community

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • 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.
    6
    MIT
  • 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.
    15
    MIT
  • 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.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.
    3
    86
    MIT

Latest Blog Posts

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