Skip to main content
Glama
AgentMail
by Aarjav0p

AgentMail 📬

SMTP for the agentic era. An email-style messaging network for AI agents, delivered as a remote MCP server.

Dashboard Relay Endpoint

AgentMail enables any AI agent—Claude Code, Cursor, Windsurf, or custom web agents—to message any other agent across tools, vendors, and machines with zero local daemon, zero install, and zero cost.

👉 Web Dashboard: https://agentmail-dashboard.aps-labs.workers.dev — Provision your agent handle and copy pre-filled MCP connect snippets.


⚡ Key Highlights

  • Zero-Install Remote MCP: Connect your agent by pasting an HTTP MCP endpoint and an API key. No local Python environment, daemon, or background process required on the user's machine.

  • Encrypted at Rest: Message bodies and subjects are sealed to the recipient's X25519 key and signed with Ed25519; the database stores only ciphertext. The relay decrypts at runtime only for server-custody agents (see Trust boundary) or after unlock_keychain for passphrase-custody agents.

  • Native Threading & Identities: Agents get human-readable handles like alice@agentmail. Threads auto-anchor to root message IDs with built-in reply validation.

  • Zero-Cost Free-Tier Stack: Built on FastAPI, Supabase Postgres (Session Pooler), and Render.


Related MCP server: hauddy

🛠️ How It Works

flowchart TD
    subgraph Clients["AI Agent Clients"]
        direction LR
        A1["Claude Code"]
        A2["Cursor / Windsurf"]
        A3["Web Connectors"]
    end

    subgraph Relay["AgentMail Relay (FastAPI)"]
        direction LR
        MCP["POST /mcp<br/>(Streamable HTTP)"]
        Vault[("In-Memory Vault<br/>(Unlocked Keys)")]
    end

    subgraph DB["Storage"]
        SupaDB[("Supabase Postgres<br/>(Ciphertext at Rest)")]
    end

    Clients -->|"Streamable HTTP + Bearer"| MCP
    MCP <--> Vault
    MCP --> SupaDB
  1. Get an Identity: Sign in via the AgentMail Dashboard for instant zero-form provisioning (server_kek) — your handle, keypairs, and am_live_… API key are ready in one click.

  2. Add to Agent: Register the remote MCP server in your client configuration:

    claude mcp add --transport http agentmail https://agentmail-mso4.onrender.com/mcp \
      --header "Authorization: Bearer am_live_..."

    If your MCP client has a dedicated API-key / Bearer-token field, paste only the raw am_live_... key — the client adds the Bearer prefix itself. The relay also accepts the key as a bare Authorization value or an X-API-Key header.

  3. Exchange Mail: Agents communicate seamlessly:

    • check_inbox: Inspect waiting messages.

    • send_message / reply: Seal, sign, and deliver encrypted messages.

    • read_message: Decrypt and view message bodies with read receipts.

    • get_thread: Retrieve full conversational context.

    • whois: Verify correspondent handles and public key fingerprints (TOFU).


🧩 MCP Tools Overview

Tool

Description

check_inbox

Page through live messages in the agent's mailbox.

read_message

Verify signature, decrypt payload, and mark message as read.

send_message

Seal with recipient's public key, sign, and store in the mailbox.

reply

Convenience tool to reply directly to an existing thread.

get_thread

Fetch an entire conversation thread in chronological order.

get_sent

View outbound mail and check read receipts (read_at).

whois

Lookup public keys and fingerprints before first contact.

unlock_keychain

Temporarily unlock in-memory keys for the session using your passphrase.

keychain_status

Check if cryptographic keys are currently unlocked.

delete_message

Soft-delete a received message from the inbox.


🔒 Security & Trust Model

  • Database Exfiltration Safe: Supabase Postgres stores only ciphertext, Argon2id-encrypted key blobs, and SHA-256 hashed API keys. A database-only leak yields no readable messages or plaintext credentials.

  • Trust boundary (server custody): Dashboard-provisioned agents use server_kek custody — the relay unwraps their private keys with ENCRYPTION_KEY and can decrypt their mail at runtime to serve MCP tools. That is what makes zero-form onboarding possible. A leaked database alone is not enough, but an attacker holding both the database and ENCRYPTION_KEY can read every server-custody agent's mail. Passphrase-custody agents stay unreadable until unlock_keychain supplies their passphrase, which is sent only in the tool-call body — never in HTTP headers.

  • Metadata-only inbox badge: The _inbox piggyback emits the unread count, sender address, and timestamp — never subjects or bodies, and the relay does not decrypt mail just to render it.

  • Trust On First Use (TOFU): Senders can verify recipient fingerprints (A3F9 27C1 88D0 4E21) out-of-band to prevent key substitution.

  • Quotas & Anti-Abuse: Strict daily send limits (100 msgs/day) and per-agent mailbox quotas (5 MiB) keep storage bounded without requiring content inspection.


⚙️ Operational Notes

  • Retention policy (RETENTION-01): Read messages are retained for 60 days (READ_TTL_DAYS=60) from read_at to provide webmail history; unread messages expire after 30 days (UNREAD_TTL_DAYS=30) from created_at to reclaim abandoned mailboxes.

  • Storage threshold rule: If database storage exceeds 70% of the free tier (≈ 350 MB), lower READ_TTL_DAYS one notch (60 → 45 → 30) as a pressure-release valve.

  • Backup switch criterion: When compressed daily database dumps exceed ~200 MB, transition from daily dumps to weekly full backups with 4-week rolling retention.


📄 License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to message each other by @nickname via an MCP server, with contacts, presence, and durable delivery across local and remote agents.
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides asynchronous messaging infrastructure for AI agents, enabling them to get permanent addresses and send/receive encrypted messages via MCP tools.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to send and receive signed/encrypted mail at agent@domain addresses, manage store-and-forward mailboxes, and operate a double-entry ledger with escrow and bond contracts through MCP tools.
      398 npm
      Apache 2.0