Agentboxd
Real email inboxes for AI agents. Create an address with one API call, send and reply from it, block until the next email arrives, and pull the one-time code or magic link out of a sign-up email.
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @agentboxd/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
AGENTBOXD_API_KEY=<secret> AGENTBOXD_BASE_URL=<value> claude mcp add com.agentboxd-mcp -- npx -y @agentboxd/mcp@0.3.0รันในเทอร์มินัล
{ "mcpServers": { "com.agentboxd-mcp": { "command": "npx", "args": [ "-y", "@agentboxd/[email protected]" ], "env": { "AGENTBOXD_API_KEY": "<secret>", "AGENTBOXD_BASE_URL": "<value>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
This repository holds the open-source clients for the hosted Agentboxd API:
homingbox.net or your own domain, with SPF, DKIM and DMARC handled.extracted_text holds only the new text of a reply, without quoted history or
signatures; attachments, threads and authentication results are all there.messages.wait() long-polls until the next matching email arrives.message.received and friends, plus a verifier in each SDK.Get an API key from the dashboard (Free plan, no card), then:
export AGENTBOXD_API_KEY=mr_...
TypeScript
import { Agentboxd } from 'agentboxd';
const mr = new Agentboxd(); // reads AGENTBOXD_API_KEY
const inbox = await mr.inboxes.create({ client_id: 'my-agent' }); // idempotent on client_id
console.log(inbox.address);
const since = new Date().toISOString();
// ...sign up somewhere with inbox.address...
const v = await mr.messages.waitForVerification(inbox.id, { since, timeout: 60 });
console.log(v?.code ?? v?.link);
Python
from agentboxd import Agentboxd
with Agentboxd() as mr: # reads AGENTBOXD_API_KEY
inbox = mr.inboxes.create(client_id="my-agent")
msg = mr.messages.wait(inbox["id"], timeout=60)
if msg:
mr.messages.reply(inbox["id"], msg["id"], text="Got it, thanks!")
MCP (Claude Code)
The hosted connector needs no API key: you sign in and choose what the client may do.
claude mcp add --transport http agentboxd https://mcp.agentboxd.com/mcp
Or run the server locally with a key:
claude mcp add agentboxd -e AGENTBOXD_API_KEY=mr_... -- npx -y @agentboxd/mcp
Then ask: "Create an inbox, sign up for the newsletter at example.com with it, and tell me the
confirmation link." Config snippets for Claude Desktop, Cursor and other clients are in
mcp/README.md.
examples/echo-agent.ts: registers a webhook and replies to every email
with a short summary. Needs a public URL for the webhook (e.g. a tunnel):
AGENTBOXD_API_KEY=mr_... AGENTBOXD_BASE_URL=https://api.agentboxd.com ECHO_WEBHOOK_URL=https://<your-tunnel>/webhook npm run echo-agentexamples/deepseek-agent/: a tool-calling agent that signs up for things
and triages an inbox, with the email-is-untrusted guardrails wired in.npm install # dev tooling for the examples (tsx, vitest)
npm run echo-agent
npm run deepseek-agent -- --demo signup
sdk/ TypeScript client (npm: agentboxd), zero runtime dependencies
mcp/ MCP server (npm: @agentboxd/mcp); inlines the TypeScript client at build time
sdk-python/ Python client (PyPI: agentboxd, coming soon)
examples/ Example agents using the TypeScript client
The Agentboxd API server itself is not part of this repository.
Issues and pull requests are welcome: see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md, not in public issues.
Real email inboxes for AI agents: send, reply, wait for mail, read OTP codes and magic links.
{ "mcpServers": { "com.agentboxd-mcp": { "command": "npx", "args": [ "-y", "@agentboxd/[email protected]" ], "env": { "AGENTBOXD_API_KEY": "<secret>", "AGENTBOXD_BASE_URL": "<value>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: AGENTBOXD_API_KEY, AGENTBOXD_BASE_URL
Agentboxd ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-18 Real email inboxes for AI agents: send, reply, wait for mail, read OTP codes and magic links.