de en es ja ko ru zh

AgentBox

Name: AgentBox
Author: RABNEER

by RABNEER

Overview Schema Source Related Servers Discussions Admin

Rust

Hybrid

⚡ AgentBox

Die E-Mail- und Identitätsebene für KI-Agenten

AgentBox gibt jedem autonomen KI-Agenten (Claude Code, Cursor, Antigravity, OpenAI Swarm) eine eigene, maschinennative E-Mail-Identität, Posteingang, ausgehende Kommunikation, Authentifizierung und ereignisgesteuerte E-Mail-Fähigkeiten – selbst gehostet, souverän und blitzschnell.

Quick Start • Kernabstraktion • Agentenidentität & Sicherheit • Anwendungsfälle • Benchmarks • MCP-Tools • Architektur

💡 Das Kernproblem

Autonome KI-Agenten brauchen eine Möglichkeit, mit der menschlichen Welt und untereinander zu interagieren. Heute ist E-Mail das universelle Kommunikationsprotokoll über alle Software und Plattformen hinweg:

Wie verifiziert ein Browser-Agent sein Konto auf GitHub oder AWS? E-Mail.
Wie kontaktiert ein Kunde deinen KI-Support-Assistenten? E-Mail.
Wie delegiert ein externer QA-Agent einen Bugreport an einen Coding-Agenten? E-Mail.
Wie erhält ein Recherche-Agent arXiv-Digests und Branchenwarnungen? E-Mail.

Ohne maschinennative E-Mail-Infrastruktur sind Entwickler gezwungen, fragile API-Polling-Lösungen zu nutzen, persönliche Gmail-Postfächer zu hacken oder Verifizierungslink manuell zu klicken.

AgentBox löst das vollständig.

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

🧑🚀 Agentenidentität & Sicherheitsmodell

AgentBox schreibt nicht vor, wer dein Agent ist. Du definierst den Namen, die E-Mail und die Capability-Policy des Agenten:

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

🔐 Mehrstufige Sicherheitsdurchsetzung:

Token-Authentifizierung: Verifiziert die Identität und den Status des Agenten (active vs. revoked).
Capability-Scopes: Validiert erforderliche Berechtigungen (inbox.read, email.send, otp.read, task.claim).
Objektbezogener Postfach-Besitz: Agent A mit otp.read ist strikt auf seine eigenen zugewiesenen Postfächer beschränkt (owner_agent_id). Ein Versuch des Zugriffs auf fremde Postfächer gibt einen expliziten AccessDenied-Fehler zurück.
Credential-Hygiene: Öffentliche Abfragen (get_agent_identity, list_agent_identities) verwenden bereinigte Strukturen, die niemals Tokens offenlegen.

🌐 Vielseitige Anwendungsfälle

AgentBox bietet die grundlegende E-Mail-Identitätsebene. Hier sind einige der leistungsstärksten Workflows, die darauf aufbauen:

1. 🤖 Agent-zu-Agent-Arbeitsdelegation & Aufgabenprotokolle

Ein externer QA- oder Discovery-Agent (wie Jules) sendet eine E-Mail mit einem Bug- oder Feature-Request. Der integrierte TaskDetector von AgentBox parst automatisch den Betreff ([TASK:BUG]), extrahiert Repository, Branch, Priorität und Zeilenangaben, erstellt eine AgentTask und weckt den Coding-Agenten über den 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 ticket

2. 🔐 Autonome SaaS-Anmeldungen & 2FA / OTP-Verifizierung

Browser-Agenten (Puppeteer, Playwright, Stagehand) müssen sich für Tools anmelden, E-Mail-Adressen verifizieren und OTP-Herausforderungen lösen:

Agent erstellt Postfach create_agent_inbox(name: "signup-bot").
Löst die Anmeldung auf der Plattform aus (z. B. AWS, Stripe, Vercel).
Ruft get_latest_otp() auf (per Regex extrahiert in <0.14ms) oder get_verification_link() (geprüft mit Anti-Redirect- & Phishing-Abwehr).
Das Konto wird autonom und ohne menschliches Eingreifen verifiziert.

3. 💬 Autonomer eingehender Support & Kundentriage

Gib deinem Kundensupport-Agenten eine eigene E-Mail-Adresse (support@yourcompany.com):

Kunde sendet eine E-Mail an den Support mit einem Problem.
AgentBox nimmt die E-Mail über rohes SMTP oder IMAP-Sync auf.
Ein Echtzeit-SSE-Event benachrichtigt den Support-Agenten.
Der Agent analysiert die Anfrage, konsultiert interne Dokumente und antwortet über send_agent_email().

4. 🔬 Recherche & Informationsbeschaffung

Gib deinem Recherche-Agenten eine Identität (researcher@yourcompany.com):

Abonniert Branchen-Newsletter, Sicherheitshinweise (CVEs) und arXiv-Digest-Feeds.
Der Agent liest eingehende E-Mails regelmäßig mit read_agent_inbox().
Erstellt Executive Briefings, fasst Ergebnisse zusammen und leitet Digests an dein Team weiter.

5. 🛡️ DevOps-Alerting & automatisierte Incident-Response

Gib deinem Incident-Response-Agenten eine Identität (oncall@yourcompany.com):

Empfängt kritische Fehlerwarnungen von Datadog, Sentry oder PagerDuty.
Ein Echtzeit-Event-Hook weckt den Agenten sofort.
Der Agent fragt Logs ab, identifiziert den fehlerhaften Commit und sendet einen Fix-Auftrag an den Coding-Agenten.

📊 Reproduzierbare Leistungs-Benchmarks

AgentBox enthält eine vollständige Benchmark-Testsuite (tests/benchmark.rs), die die gesamte Pipeline von rohen Bytes bis zur vollständigen JSON-RPC-Ausgabe misst:

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

⚡ Verifizierte vollständige End-to-End-MCP-Pipeline (1.000 Zyklen):

Getestete 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-Metrik	Gemessene Latenz	Durchsatz
Durchschnitt (Mittelwert)	`451,9 µs` (0,451 ms)	2.213 vollständige MCP-Zyklen/Sek.
p50-Median	`431,5 µs` (0,431 ms)	—
p95	`586,2 µs` (0,586 ms)	—
p99	`1,04 ms`	—

⚡ Sub-Komponenten-Mikrosekunden-Latenzen (10.000 Iterationen):

Event-Bus-Kanal-Dispatch: 0,216 µs (0,0002 ms) — 4,62 Millionen Events/Sek.
Link-Sicherheit & Anti-Redirect: 0,652 µs (0,0007 ms) — 1,53 Millionen Checks/Sek.
OTP-Regex-Extraktion: 138,2 µs (0,138 ms) — 7.230 Extraktionen/Sek.

🛠️ MCP-Tools-Referenz

AgentBox implementiert die Model Context Protocol (MCP)-Spezifikation über stdio:

Kategorie	Tool	Parameter	Beschreibung
Identität	`create_agent_identity`	`name, email?, capabilities?`	Erstellt eine persistente Identität mit benutzerdefinierter/automatischer E-Mail und gibt ein einmaliges Auth-Token zurück.
Identität	`get_agent_identity`	`agent_id`	Ruft öffentliche Agenten-Metadaten ab (Tokens werden bereinigt).
Identität	`list_agent_identities`	—	Listet alle registrierten öffentlichen Agenten-Identitäten und aktiven Policies auf.
Identität	`revoke_agent_identity`	`agent_id`	Widerruft eine Agenten-Identität und invalidiert sofort ihr Auth-Token.
Postfach	`create_agent_inbox`	`name, address?, agent_token?`	Erstellt ein neues virtuelles Postfach, das mit der aufrufenden Agenten-Identität verknüpft ist.
Postfach	`get_latest_otp`	`account_id, agent_token?`	Extrahiert den neuesten 4–8-stelligen Verifizierungscode in <0,14ms mit Besitzprüfung.
Postfach	`wait_for_email`	`account_id, timeout_secs?, agent_token?`	Event-Driven Hook: Async-Tokio-Broadcast-Kanal weckt den Agenten in <0,001ms.
Postfach	`get_verification_link`	`account_id, agent_token?`	Gibt geparste Aktivierungslinks mit Deep-Link-Sicherheit & Anti-Redirect-Abwehr zurück.
Postfach	`read_agent_inbox`	`account_id, limit?, agent_token?`	Ruft aktuelle Nachrichten, vollständigen Text, HTML und Absender-Metadaten ab.
Postfach	`send_agent_email`	`account_id, to, subject, body, agent_token?`	Sendet ausgehende E-Mails über SMTP-Relay mit Capability-Autorisierung.
Postfach	`delete_agent_inbox`	`account_id, agent_token?`	Löscht ein temporäres Postfach und entfernt gespeicherte Nachrichten.
Aufgabenprotokoll	`dispatch_agent_task`	`action, description, repository?, branch?, priority?, target_agent?, evidence?, acceptance_criteria?, agent_token?`	Sendet einen strukturierten Arbeitsauftrag von einem Agenten an einen anderen.
Aufgabenprotokoll	`claim_agent_task`	`task_id, agent_token`	Sperrt und weist eine Aufgabe atomar dem beanspruchenden Worker-Agenten zu.
Aufgabenprotokoll	`update_task_progress`	`task_id, status, commit_sha?, pr_url?, test_results?, note?, agent_token`	Aktualisiert den Aufgabenstatus (`running`, `testing`, `pr_opened`) und protokolliert im Audit-Log.
Aufgabenprotokoll	`complete_agent_task`	`task_id, summary, commit_sha?, pr_url?, test_results?, agent_token`	Schließt eine Aufgabe mit Abschlussdetails ab und sendet ein Abschluss-Event.
Aufgabenprotokoll	`list_agent_tasks`	`status?, agent_token?, limit?`	Listet Aufgaben gefiltert nach Lebenszyklus-Status oder Agenten-Identität.
Aufgabenprotokoll	`get_task_audit_trail`	`task_id, agent_token?`	Ruft das unveränderliche Audit-Log und den Lebenszyklus-Verlauf einer Aufgabe ab.

🚀 Quick Start

1. Headless-NPM-CLI (Null Setup)

Konfiguriere deine KI-Tools sofort in 1 Sekunde automatisch:

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

3. Hochgeschwindigkeits-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

🏗️ Architektur

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

📄 Lizenz

Verteilt unter der MIT-Lizenz. Weitere Informationen finden Sie in LICENSE.

Mit 🖤 erstellt von RABNEER & der AgentBox Open Source Community

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