Skip to main content
Glama

⚡ AgentBox

Die souveräne autonome Mailbox- & Identitätsebene für KI-Agenten

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

AgentBox gibt autonomen KI-Codierungsagenten (Claude Code, Cursor, Antigravity, OpenAI Swarm) dauerhafte maschinennative E-Mail-Identitäten, Objektautorisierung und souveräne Kommunikationsinfrastruktur. Empfangen Sie E-Mails, erfassen Sie 2FA-Verifizierungscodes in <0.14ms, verifizieren Sie Aktivierungs-Magic-Links mit Anti-Phishing-Schutz und senden Sie ausgehende Antworten ohne Bindung an Drittanbieter-Clouds.

SchnellstartAgentenidentität & -sicherheitBenchmarksMCP-ToolsLink-SicherheitArchitektur


💡 Warum AgentBox?

Wenn autonome KI-Agenten Software entwickeln, Konten auf Entwicklerplattformen registrieren oder automatisierte QA-Pipelines ausführen, stoßen sie unweigerlich auf E-Mail-Verifizierung, 2FA und Identitätshürden.

Problem mit herkömmlichen Ansätzen

Die souveräne AgentBox-Lösung

❌ Kostenpflichtige SaaS-E-Mail-APIs berechnen pro E-Mail und erfordern Kreditkarten

100 % kostenlos & selbst gehostet auf lokalem SQLite (agentbox.db)

❌ Webhook-Dienste erfordern öffentliche URLs / Tunneling (Ngrok)

Integrierter IMAP-TLS-Poller & roher eingehender SMTP-Server (Hostinger, Titan, Google, Stalwart)

❌ Polling von REST-APIs dauert 5–30 Sekunden mit Rate-Limit-Engpässen

Ereignisgesteuertes asynchrones Aufwecken (<0.001ms) über Tokio-Broadcast-Kanäle

❌ Datenlecks zwischen Agenten durch nicht authentifizierte Tools

Verpflichtende eingeschränkte Fähigkeiten & Objektbesitz auf Ressourcenebene

❌ Agenten mangelt es an Sicherheit und fallen auf Phishing-/Open-Redirect-Links herein

Leistungsstarke URL-Sicherheits-Engine (Punycode-, Raw-IP- und Open-Redirect-Abwehr)

❌ Manuelle MCP-Einrichtung erfordert komplexe JSON-Bearbeitung in IDE-Konfigurationen

npx agentbox-mail init 1-Klick-Konfiguration für Claude Code, Cursor & Antigravity


Related MCP server: Mailgent MCP Server

🧑🚀 Erstklassige Agentenidentität & Sicherheit auf Objektebene

AgentBox geht über generische Postfächer hinaus, indem Erstklassige Agentenidentitäten mit strengem Objektbesitz auf Ressourcenebene eingeführt werden:

# Provision a scoped identity for an autonomous browser QA agent
npx agentbox-mail agent create browser-qa --capabilities "inbox.read,otp.read,links.read"
╔══════════════════════════════════════════════════════════════════╗
║             🧑‍🚀 AGENT IDENTITY PROVISIONED                      ║
╠══════════════════════════════════════════════════════════════════╣
║  Agent ID     : agent_browser-qa_7f92a1                          ║
║  Name         : browser-qa                                       ║
║  Email        : browser-qa-7f92a1@apocalypto.in                  ║
║  Auth Token   : agb_92d7e8f1c3a04b12                             ║
║  Capabilities : ["inbox.read", "otp.read", "links.read"]         ║
║  Status       : active                                           ║
╚══════════════════════════════════════════════════════════════════╝
⚠️  NOTE: Store this auth_token securely. It is only displayed once upon creation and cannot be retrieved again.

🔐 Mehrstufige Sicherheitsdurchsetzung:

                Incoming Tool / API Request
                            │
                            ▼
              ┌───────────────────────────┐
              │ 1. Validate Auth Token    │ ➔ Reject if invalid or revoked
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 2. Check Capability Scope │ ➔ E.g. Require "otp.read"
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 3. Object-Level Ownership │ ➔ Agent A CANNOT read Agent B's mailbox
              └─────────────┬─────────────┘
                            │
                            ▼
              ┌───────────────────────────┐
              │ 4. Execute Protected Tool │
              └───────────────────────────┘
  • Credential-Hygiene: Tokens werden bei der Erstellung nur einmal angezeigt. Lese-Endpunkte (get_agent_identity, list_agent_identities) verwenden sichere öffentliche Strukturen, die niemals Authentifizierungsgeheimnisse preisgeben.

  • Cross-Agent-Isolation: Ein Agent mit otp.read ist strikt auf die Postfächer beschränkt, die er besitzt (owner_agent_id). Der Versuch eines postfachübergreifenden Zugriffs gibt einen strukturierten AccessDenied-Fehler zurück.


📊 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)

681.3 µs (0.681 ms)

1,468 vollständige MCP-Zyklen/Sek.

p50-Median

590.0 µs (0.590 ms)

p95

1.20 ms

p99

1.58 ms

⚡ Mikrosekunden-Latenzen der Teilkomponenten (10,000 Iterationen):

  • Event-Bus-Kanal-Dispatch: 0.216 µs (0.0002 ms) — 4.62 Millionen Ereignisse/Sek.

  • Link-Sicherheit & Anti-Redirect: 0.652 µs (0.0007 ms) — 1.53 Millionen Prüfungen/Sek.

  • OTP-Regex-Extraktion: 138.2 µs (0.138 ms) — 7,230 Extraktionen/Sek.

Hinweis: Die Ankunftslatenz externer E-Mails hängt von der vorgelagerten E-Mail-Zustellung ab; sobald Bytes bei AgentBox (SMTP/IMAP/HTTP) eintreffen, sind End-to-End-Parsing, DB-Persistenz, Berechtigungsautorisierung und JSON-RPC-Antwort in <0.7ms abgeschlossen.


Um autonome Agenten vor Credential-Harvesting und bösartigen offenen Weiterleitungen zu schützen, analysiert AgentBox alle eingehenden Links mit einem tiefgehenden Sicherheitsanalysator:

  • 🚫 Open-Redirect-Erkennung: Untersucht Parameter wie ?redirect=, ?url=, ?next=, ?dest=, ?to=.

  • 🚫 Raw-IP-Adressen-Abwehr: Blockiert URLs, die auf rohe IPv4-Adressen statt auf seriöse Hostnamen abzielen.

  • 🚫 Punycode-Homograph-Abwehr: Kennzeichnet Unicode-/Punycode-Domain-Spoofing (xn--).

  • 🔒 Protokollvalidierung: Unterscheidet sichere HTTPS-Endpunkte von unsicherem HTTP.

{
  "url": "https://signin.aws.amazon.com/verify?token=abc_123",
  "domain": "signin.aws.amazon.com",
  "is_safe": true,
  "has_open_redirect": false,
  "confidence": 0.98
}

🛠️ MCP-Tools-Referenz

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

Kategorie

Tool

Parameter

Beschreibung

Identität

create_agent_identity

name, capabilities?

Erstellt eine dauerhafte Identität und gibt ein einmaliges geheimes Authentifizierungstoken zurück.

Identität

get_agent_identity

agent_id

Ruft öffentliche Agentenfähigkeiten, Status und Metadaten ab (Token bereinigt).

Identität

list_agent_identities

Listet alle registrierten öffentlichen Agentenidentitäten auf.

Identität

revoke_agent_identity

agent_id

Widerruft eine Agentenidentität und macht ihr Authentifizierungstoken sofort ungültig.

Postfach

create_agent_inbox

name, address?, agent_token?

Erstellt ein neues virtuelles Postfach, das mit der aufrufenden Agentenidentität verknüpft ist.

Postfach

get_latest_otp

account_id, agent_token?

Extrahiert den neuesten 4–8-stelligen Verifizierungscode mit Eigentümerprüfung.

Postfach

wait_for_email

account_id, timeout_secs?, agent_token?

Ereignisgesteuerter Hook: Ein asynchroner Tokio-Broadcast-Kanal weckt den Agenten in <0.001ms auf.

Postfach

get_verification_link

account_id, agent_token?

Gibt geparste Aktivierungslinks mit Link-Sicherheits- & Anti-Redirect-Analyse zurück.

Postfach

read_agent_inbox

account_id, limit?, agent_token?

Ruft aktuelle Nachrichten, vollständigen Text, HTML und Absendermetadaten ab.

Postfach

send_agent_email

account_id, to, subject, body, agent_token?

Sendet ausgehende E-Mails über ein SMTP-Relay mit Berechtigungsprüfung.

Postfach

delete_agent_inbox

account_id, agent_token?

Löscht ein temporäres Postfach und entfernt gespeicherte Nachrichten.


🚀 Schnellstart

1. Headless-NPM-CLI (keine Einrichtung)

Konfigurieren Sie Ihre 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
npx agentbox-mail mcp

# Create an Agent Identity with scoped capabilities
npx agentbox-mail agent create coder --capabilities "inbox.read,otp.read,links.read"

# Retrieve latest OTP code
npx agentbox-mail otp agent@yourdomain.com

# Launch Web Dashboard
npx agentbox-mail ui

2. Native Electron-Desktop-App

Für ein vollständiges eigenständiges Desktop-Erlebnis mit Systemleiste und Betriebssystem-Benachrichtigungen:

# 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

                                  ┌───────────────────────────┐
                                  │   Incoming Mail Sources   │
                                  └─────────────┬─────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Hostinger / Titan /   │      │ Raw SMTP Listener     │      │ Inbound HTTP Webhook  │
     │ Google IMAP TLS (993) │      │ (0.0.0.0:2525)        │      │ (POST /v1/inbound)    │
     └───────────┬───────────┘      └───────────┬───────────┘      └───────────┬───────────┘
                 │                              │                              │
                 └──────────────────────────────┼──────────────────────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │   High-Speed Regex Parser   │
                                 │  • 4–8 Digit OTP Isolator   │
                                 │  • Link Safety Engine       │
                                 └──────────────┬──────────────┘
                                                │
                                                ▼
                                 ┌─────────────────────────────┐
                                 │ Embedded SQLite Storage     │
                                 │       (`agentbox.db`)       │
                                 │  • Accounts  • Identities   │
                                 │  • Messages  • Capabilities │
                                 │  • Resource Ownership Graph │
                                 └──────────────┬──────────────┘
                                                │
                 ┌──────────────────────────────┼──────────────────────────────┐
                 │                              │                              │
                 ▼                              ▼                              ▼
     ┌───────────────────────┐      ┌───────────────────────┐      ┌───────────────────────┐
     │ Realtime SSE Bus      │      │ MCP Server (stdio)    │      │ Native Desktop App /  │
     │ (`GET /v1/events`)    │      │ Scoped Capabilities   │      │ Web Dashboard (:3000) │
     │                       │      │ Object-Level Auth     │      │                       │
     └───────────────────────┘      └───────────────────────┘      └───────────────────────┘

📄 Lizenz

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

Mit 🖤 erstellt von RABNEER & der AgentBox-Open-Source-Community

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

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

  • 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
    -
    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.
    22
    MIT
  • A
    license
    -
    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
    96
    MIT

View all related MCP servers

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.

View all MCP Connectors

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