Skip to content

feat(examples): add mcp-atomicmail-js - #116

Open
7supersayin wants to merge 1 commit into
e2b-dev:mainfrom
7supersayin:add-mcp-atomicmail-example
Open

feat(examples): add mcp-atomicmail-js#116
7supersayin wants to merge 1 commit into
e2b-dev:mainfrom
7supersayin:add-mcp-atomicmail-example

Conversation

@7supersayin

Copy link
Copy Markdown

What this adds

A new Model Context Protocol example — examples/mcp-atomicmail-js — that gives an agent running in an E2B sandbox its own email inbox using the Atomic Mail MCP server (@atomicmail/mcp).

The example:

  1. Runs the Atomic Mail stdio MCP server inside an E2B sandbox via E2B's MCP gateway, exposing the register, jmap_request, and help tools over authenticated HTTP.
  2. Calls register to create a fresh @atomicmail.ai inbox via a proof-of-work signup — no human, no CAPTCHA, and no Atomic Mail API key.
  3. Sends an email with the bundled send_mail JMAP preset.
  4. Polls the inbox with the list_inbox preset and reads the message back.

It follows the structure and quality of the existing mcp-custom-server-js example (same index.ts + package.json + tsconfig.json + env.template + README.md + package-lock.json layout), and adds a row to the Model Context Protocol (MCP) table in the root README.md.

Why it's useful to the E2B ecosystem

Autonomous agents constantly hit "please verify your email." Atomic Mail removes that wall: an agent signs itself up in ~30 seconds and owns a real, deliverable inbox end to end — no human setup. Inside an E2B sandbox this unlocks email verification, newsletter digests, support inboxes, and async email surveys, all hands-free. The only credential the user provides is their E2B_API_KEY.

Testing status

Verified end to end against a live E2B sandbox (registersendreceive):

Creating E2B sandbox with the Atomic Mail MCP server...
Sandbox created successfully
Connected successfully
Registering inbox for "e2b-agent-kg9jyb" (proof-of-work signup)...
Inbox registered: e2b-agent-kg9jyb@atomicmail.ai
Sending mail to e2b-agent-kg9jyb@atomicmail.ai...
Mail submitted
Polling the inbox for the message to arrive...
Received after 1 poll(s):
  From:    e2b-agent-kg9jyb@atomicmail.ai
  Subject: Hello from an E2B sandbox agent [GKGU07]
Done.

tsc --noEmit also passes cleanly. To reproduce: cp env.template .env, add your E2B_API_KEY, then npm install && npm start.

Links

Add a Model Context Protocol example that gives an E2B sandbox agent its
own email inbox using the Atomic Mail MCP server (@atomicmail/mcp). The
agent registers an @atomicmail.ai address via proof-of-work (no human, no
CAPTCHA, no API key), then sends and receives mail over JMAP.

Verified end to end against a live E2B sandbox: register -> send -> receive.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cla-bot

cla-bot Bot commented Aug 7, 2026

Copy link
Copy Markdown

We require contributors to sign our Contributor License Agreement, and we don't have @7supersayin on file. You can sign our CLA at https://e2b.dev/docs/cla . Once you've signed, post a comment here that says '@cla-bot check'

@7supersayin

Copy link
Copy Markdown
Author

@cla-bot check

@cla-bot

cla-bot Bot commented Aug 7, 2026

Copy link
Copy Markdown

We require contributors to sign our Contributor License Agreement, and we don't have @7supersayin on file. You can sign our CLA at https://e2b.dev/docs/cla . Once you've signed, post a comment here that says '@cla-bot check'

@cla-bot

cla-bot Bot commented Aug 7, 2026

Copy link
Copy Markdown

The cla-bot has been summoned, and re-checked this pull request!

@7supersayin

Copy link
Copy Markdown
Author

@cla-bot check

@cla-bot cla-bot Bot added the cla-signed label Aug 7, 2026
@cla-bot

cla-bot Bot commented Aug 7, 2026

Copy link
Copy Markdown

The cla-bot has been summoned, and re-checked this pull request!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant