开发者

基于 ChatTempMail API 构建

带 AI 能力的临时邮箱 —— REST API、OpenAPI 3.1 规范、MCP 服务器、Agent Skill 与 Webhook。一分钟内拿到 API 密钥和一次性收件箱。

快速开始

三次调用拿到第一个验证码。Base URL：https://chat-tempmail.com。所有端点支持 X-API-Key 或 Authorization: Bearer。

1) List available domains

curl https://chat-tempmail.com/api/email/domains \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

2) Create a disposable address (1 hour)

curl -X POST https://chat-tempmail.com/api/emails/generate \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "test", "expiryTime": 3600000, "domain": "chat-tempmail.com"}'

3) Poll for messages

curl https://chat-tempmail.com/api/emails/{emailId} \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY"

机器可读资源

Agent 可以按名称发现的固定 URL：

OpenAPI 3.1 规范

完整 REST API schema，含 operationId、类型化参数与响应 schema。亦可在 /api/openapi.json 与 /.well-known/openapi.json 获取。

llms.txt

Markdown 格式的站点与 API 概览，含 agent when-to-use 指引。发送 Accept: text/markdown 时以 text/markdown 返回。

MCP 服务器

Claude、Cursor、VS Code 的原生工具访问。通过 npm 本地运行：mcp-server-tempmail。

Agent Skill

可安装的 Skill，教会编码 agent 完整的创建收件箱 → 轮询 → AI 处理工作流。

CLI 与 MCP 包

npx mcp-server-tempmail 可作为 CLI 工具独立使用；官方 npm 包。

认证

无需 OAuth：在个人资料页创建 API 密钥并放入请求头即可。密钥与账号权限一致——泄露请立即重新生成。

1登录并打开个人资料页
2创建 API 密钥（仅显示一次，请妥善保存）
3每个请求携带 X-API-Key: YOUR_API_KEY（或 Authorization: Bearer YOUR_API_KEY）

X-API-Key: YOUR_API_KEY

Webhook

无需轮询：配置 webhook（POST /api/webhook）后，每封新邮件都会以 X-Webhook-Event: new_message 头 POST 到你的 URL。请尽快返回 2xx；失败会重试，请保持幂等。

Configure a webhook

curl -X POST https://chat-tempmail.com/api/webhook \
  -H "X-API-Key: $CHATTEMPMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "enabled": true}'

沙箱与速率限制

没有独立沙箱：每个账号都可以免费创建临时邮箱。付费方案解锁 AI 操作（摘要/翻译/问答/提取）、永久邮箱与附件。列表端点每页 20 条，基于游标分页。AI 端点有按角色的每日限额，响应头 X-AI-Remaining 会返回余量。

支持

问题、bug 反馈、功能建议：

GitHub 邮箱