PS

pexni/smails

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

39 stars 4 forks 品質 75 トレンド 16MIT

エージェントネイティブ使い捨てメール — Cloudflare ワーカー + 耐久性のあるオブジェクト、CLI & MCP. [https://smails.dev]]

概要

サインアップ、ワンタイムコード、および確認のためのインスタント、匿名のスローウェイトインボックス - REST API、CLI、および、あなたのAIエージェントは検証メールを受け取ることができます。 サインアップ、パスワードなし エージェントに独自の受信トレイを与えます:MCPサーバーをClaude、Cursor、またはMCPクライアントに差し込み、メールボックスを作成して、受信メール(検証コード、マジックリンク)を独自に読むことができます。 - - - サイトを開き、アドレス、ゼロクリック - - 新しいメールはWebSocket、ポーリングなしに到着 - - - REST API、CLI、およびMCPサーバーが同じメールボックスを共有 - - 設定可能な受信ドメインから選択 - - - - - 活動中の7日後にメールボックス自動有効期限 - - - - クラウドフレアワーカー+耐久性のあるオブジェクト(メールボックス、SQLiteストレージごとに1 DO) 訪問 — 受信トレイは、最初の読み込み時に作成されます。 サーバを任意の MCP クライアント (例えば Claude デスクトップ, ~/.claude/mcp.json) に追加します。 ツール: create mailbox, list messages, read message, delete message, get address.

概要(AI 翻訳)

人やAIエージェントの使い捨てメール。 サインアップ、ワンタイムコード、および確認のためのインスタント、匿名のスローウェイトインボックス - REST API、CLI、およびMCPサーバーで、AIエージェントは検証メールを受け取ることができます。 サインアップ、パスワードなし

→smails.dev・npx @smails/cli create

自分の受信トレイをエージェントに:MCPサーバーをClaude、Cursor、または任意のMCPクライアントに差し込み、メールボックスを作成し、受信メール(検証コード、マジックリンク)を独自に読むことができます。

##特徴

  • Instant inbox — サイトを開き、アドレス、ゼロクリック
  • リアルタイム — 新しいメールはWebSocket、花粉なしに到着します
  • エージェントの許可 — REST API、CLI、MCP サーバーが同じメールボックスを共有
  • マルチドメイン — 設定可能な受信ドメインから選択
  • 自己クリーニング — 活動の7日後にメールボックス自動有効期限
  • Serverless — Cloudflareワーカー+耐久性のあるオブジェクト(メールボックス、SQLiteストレージごとに1つのDO)

クイックスタート

####ウェブ

smails.dev* にアクセスしてください。最初の読み込み時に受信トレイが作成されます。

###CLI は

##MCP(AIエージェント向け)

サーバを MCP クライアント (例えば Claude デスクトップ, [~/.claude/mcp.json]]) に追加します

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

smails

Disposable email for humans and AI agents. An instant, anonymous throwaway inbox for sign-ups, one-time codes, and confirmations — with a REST API, a CLI, and an MCP server, so your AI agent can receive verification emails too. No signup, no password.

→ smails.dev · npx @smails/cli create

Give your agent its own inbox: plug the MCP server into Claude, Cursor, or any MCP client and it can create a mailbox and read incoming mail (verification codes, magic links) on its own.

Features

  • Instant inbox — open the site and you have an address, zero clicks
  • Real-time — new mail arrives over WebSocket, no polling
  • Built for agents — REST API, CLI, and an MCP server share the same mailbox
  • Multi-domain — pick from configurable receiving domains
  • Self-cleaning — mailboxes auto-expire after 7 days of inactivity
  • Serverless — Cloudflare Workers + Durable Objects (one DO per mailbox, SQLite storage)

Quick start

Web

Visit smails.dev — an inbox is created for you on first load.

CLI

npx @smails/cli create      # create a mailbox (token saved to ~/.smails)
npx @smails/cli inbox       # list messages
npx @smails/cli read    # read a message (id prefix is enough)
npx @smails/cli whoami      # show the current address
npx @smails/cli create --force  # replace with a fresh mailbox

MCP (for AI agents)

Add the server to any MCP client (e.g. Claude Desktop, ~/.claude/mcp.json):

{
  "mcpServers": {
    "smails": { "command": "npx", "args": ["@smails/cli", "mcp"] }
  }
}

Tools: create_mailbox, list_messages, read_message, delete_message, get_address.

REST API

# create a mailbox
curl -X POST https://smails.dev/api/mailbox
# → { "address": "...", "token": "..." }

# list messages with the returned token
curl https://smails.dev/api/mailbox/messages \
  -H "Authorization: Bearer "
Method Path Description
POST /api/mailbox Create a mailbox → { address, token }
GET /api/mailbox/messages List messages
GET /api/mailbox/messages/:id Read a message (full parsed body)
DELETE /api/mailbox/messages/:id Delete a message
WS /api/mailbox/connect?token= Stream new-mail notifications

Authenticate every request (except create) with Authorization: Bearer .

How it works

Inbound mail ──▶ Cloudflare Email Routing (catch-all)
                          │
                          ▼
                  Worker  email() handler ──┐
                                            ▼
GitHub で README 全文を見る

インストール

npx @smails/cli mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "smails": { "command": "npx", "args": ["@smails/cli", "mcp"] } } }