Mailgi

Mailgi

面向 AI Agent 的电子邮件。 每个 Agent 都有一个真实、可投递的邮箱，并且完全通过 REST 使用——无需 SMTP 或 IMAP 客户端。

Agent 只需发送一个无需身份验证的 POST 请求即可注册，并获得一个可接收验证码、回复邮件并保存邮件的地址。接收邮件免费；向外部发送邮件按量付费。也可通过 https://api.mailgi.xyz/mcp 使用托管式 MCP 服务。

• 网站：https://www.mailgi.xyz
• 指南：https://www.mailgi.xyz/guides.html（验证码、支持收件箱、OpenAI Agents SDK、LangChain）
• 文档：https://www.mailgi.xyz/docs.html
• API 文档：https://api.mailgi.xyz/docs
• 面向 Agent 的参考资料：https://www.mailgi.xyz/SKILL.md

此仓库

路径	内容	状态
packages/typescript	TypeScript SDK + mailgi CLI — npm @mailgi/mailgi	已发布
packages/python	Python SDK — PyPI mailgi	计划中
apps/ui	用于检查邮箱的 React 开发者界面	开发工具
spec	openapi.json — 每个 SDK 所遵循的契约	—

API 和邮件基础设施位于单独的私有仓库中。

快速开始

npm install -g @mailgi/mailgi

mailgi register --label my-agent          # saves to ~/.mailgi/config.json
mailgi send --agent <handle> --to [email protected] --subject Hi --body Hello
mailgi inbox --agent <handle>

也可以在代码中使用：

import { AgentMailboxClient } from "@mailgi/mailgi";

const client = AgentMailboxClient.withApiKey("https://api.mailgi.xyz", process.env.MAILGI_API_KEY!);
await client.sendMail({ to: ["[email protected]"], subject: "Hi", textBody: "Hello" });

MCP 服务

Mailgi 在 https://api.mailgi.xyz/mcp 提供托管式 MCP 服务（Streamable HTTP），与 REST API 一一对应。开始使用无需 API 密钥：Agent 调用 register_agent，即可获得自己的地址和密钥。

claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp

Cursor、Claude Desktop 和其他客户端的配置方法：https://www.mailgi.xyz/mcp.html。 server.json 是官方 MCP Registry 中 xyz.mailgi/mailgi 条目的配置文件。

在此仓库中开发

npm install                      # installs all workspaces
npm run build                    # builds every package
npm test                         # runs every package's tests
npm run dev -w @mailgi/ui        # developer UI on :5173

工作区在根目录的 package.json 中显式列出，而非使用 glob 匹配，因此 packages/python 等非 Node 包可以与它们并存，不会造成 npm 混淆。

发布标签按包命名空间区分——ts-sdk-v0.2.0、py-sdk-v0.1.0——因为各 SDK 独立进行版本管理。

许可证

MIT