ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้ว
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว
☰ เมนูไทย ตั้งค่า
โหมดมือใหม่ เปิด
สีหน้าจอตามเครื่องสว่างมืด
ภาษาไทยEnglish中文日本語한국어EspañolDeutsch

Mailsnail

โดย iancollins27รุ่น 0.6.1i★ 0iบนเครื่องหรือคลาวด์
ชื่อใน registryio.github.iancollins27/mailsnail

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ คลาวด์หรือติดตั้งในเครื่อง
  • บัญชีหรือคีย์ คลาวด์: ล็อกอินกับบริการตอนต่อ (OAuth) · ในเครื่อง: ต้องมี MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY
  • หมวด อื่น ๆ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Send USPS letters & certified mail from any agent. Hosted: sign in, no install.

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (api.mailsnail.dev)

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4

  2. กด “+ Add” → “Add custom connector” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อMailsnail
    Remote MCP server URL · ที่อยู่https://api.mailsnail.dev/mcp

    หัวข้อ Authentication ปล่อยตามที่ Claude ตรวจเจอ แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsMailsnail

  4. ลองเลย

    ใช้ Mailsnail บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Mailsnail หรือมีชื่อเครื่องมือของ Mailsnail ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ เฉพาะแผนองค์กร

ใช้ได้กับ ChatGPT Business, Enterprise หรือ Edu บนเว็บ และแอดมินหรือเจ้าของ workspace ต้องเป็นคนเพิ่ม · ถ้าใช้ Free, Plus หรือ Pro: ChatGPT แผนของคุณยังต่อ MCP เองไม่ได้

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4

  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อMailsnail
    Connection · ที่อยู่https://api.mailsnail.dev/mcp

  3. เลือก Mailsnail ในแชต

    เปิดแชตใหม่แล้วเลือก Mailsnail จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Mailsnail บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Mailsnail หรือมีชื่อเครื่องมือของ Mailsnail ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport http --scope user mailsnail https://api.mailsnail.dev/mcp

  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Mailsnail ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Mailsnail บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Mailsnail หรือมีชื่อเครื่องมือของ Mailsnail ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Mailsnail บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Mailsnail หรือมีชื่อเครื่องมือของ Mailsnail ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Mailsnail บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Mailsnail หรือมีชื่อเครื่องมือของ Mailsnail ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://api.mailsnail.dev/mcp

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Mailsnail อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport http --scope user mailsnail https://api.mailsnail.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mailsnail": {
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "mailsnail": {
      "type": "http",
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}

ติดตั้งในเครื่อง

Claude Code

claude mcp add --scope user mailsnail --env MAIL_PROVIDER='ใส่ค่าของคุณ' --env MAIL_API_BASE_URL='ใส่ค่าของคุณ' --env CLICK2MAIL_USERNAME='ใส่ค่าของคุณ' --env CLICK2MAIL_PASSWORD='ใส่ค่าของคุณ' --env LOB_API_KEY='ใส่ค่าของคุณ' --env MAIL_MCP_ALLOW_LIVE='ใส่ค่าของคุณ' --env MAIL_MCP_SPEND_CAP_USD='ใส่ค่าของคุณ' -- npx -y mailsnail

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "mailsnail": {
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "ใส่ค่าของคุณ",
        "MAIL_API_BASE_URL": "ใส่ค่าของคุณ",
        "CLICK2MAIL_USERNAME": "ใส่ค่าของคุณ",
        "CLICK2MAIL_PASSWORD": "ใส่ค่าของคุณ",
        "LOB_API_KEY": "ใส่ค่าของคุณ",
        "MAIL_MCP_ALLOW_LIVE": "ใส่ค่าของคุณ",
        "MAIL_MCP_SPEND_CAP_USD": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mailsnail": {
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "ใส่ค่าของคุณ",
        "MAIL_API_BASE_URL": "ใส่ค่าของคุณ",
        "CLICK2MAIL_USERNAME": "ใส่ค่าของคุณ",
        "CLICK2MAIL_PASSWORD": "ใส่ค่าของคุณ",
        "LOB_API_KEY": "ใส่ค่าของคุณ",
        "MAIL_MCP_ALLOW_LIVE": "ใส่ค่าของคุณ",
        "MAIL_MCP_SPEND_CAP_USD": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "mailsnail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "ใส่ค่าของคุณ",
        "MAIL_API_BASE_URL": "ใส่ค่าของคุณ",
        "CLICK2MAIL_USERNAME": "ใส่ค่าของคุณ",
        "CLICK2MAIL_PASSWORD": "ใส่ค่าของคุณ",
        "LOB_API_KEY": "ใส่ค่าของคุณ",
        "MAIL_MCP_ALLOW_LIVE": "ใส่ค่าของคุณ",
        "MAIL_MCP_SPEND_CAP_USD": "ใส่ค่าของคุณ"
      }
    }
  }
}

ค่าที่ต้องใส่เอง

  • MAIL_PROVIDER จำเป็น env
    For self-hosting only; most people should add the hosted URL instead. 'click2mail' (your own account) or 'lob' (your own key). 'managed' needs a Stripe Shared Payment Token that most AI apps can't cr…
  • MAIL_API_BASE_URL env
    Hosted Mailsnail backend. Required when MAIL_PROVIDER=managed.
  • CLICK2MAIL_USERNAME env
    Click2Mail account username. Required when MAIL_PROVIDER=click2mail.
  • CLICK2MAIL_PASSWORD ความลับ env
    Click2Mail account password. Required when MAIL_PROVIDER=click2mail.
  • LOB_API_KEY ความลับ env
    Lob API key. Required when MAIL_PROVIDER=lob. test_* is free; live_* actually mails.
  • MAIL_MCP_ALLOW_LIVE env
    Set to '1' to actually mail in BYOK modes. Default '0' is dry-run.
  • MAIL_MCP_SPEND_CAP_USD env
    Per-session estimated spend cap. Server refuses sends past this.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
44/สัปดาห์
การเชื่อมต่อ
บนเครื่องหรือคลาวด์
รุ่นล่าสุดi
0.6.1
หมวดi
อื่น ๆ
ส่งเข้า registryi
7 พ.ย. 2569
แก้โค้ดล่าสุดi
10 พ.ย. 2569
ผู้ทำ
iancollins27
แพ็กเกจ
npm: mailsnail
เว็บผู้ทำ
mailsnail.dev
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ติดตั้งบนเครื่องได้ใน

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

เรื่องที่ 8เช็ก 5 ข้อก่อนติดตั้ง MCP ไม่ให้ข้อมูลรั่วใช้เวลาราว 2 นาทีต่อตัว ดูจากหน้าของตัวนั้นบนเว็บเรา และหน้าขออนุญาตของโปรแกรม AI ก่อนกดยอมอ่าน 4 นาที

ทำอะไรได้บ้าง

server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 12 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub iancollins27 ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด เมื่อวานซืน

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 450 ms (HTTP 401)

  • ✓ ผ่าน

    ล็อกอินแบบ OAuth

    ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบด้วย Google เพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด อื่น ๆi

  • ดาวมากกว่า 0% ของอีก 19377 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 88% ของอีก 19377 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 19377 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Mailsnail ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวานซืน และส่งรุ่นล่าสุด (0.6.1) เข้า registry 5 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT แผน Business ขึ้นไป

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี World Monitor, Claude Flow, Windmill

ตัวอื่นในหมวดเดียวกัน

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

World Monitor

ข่าวกรองโลกแบบเรียลไทม์: ความขัดแย้ง ตลาด พลังงาน การค้า การขนส่ง และไซเบอร์

โดย koala73ใช้กันมาก★ 90.5Kอัปเดต วันนี้

รันบนคลาวด์✓ เจ้าของบริการ · worldmonitor.app
ติดตั้ง

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

โดย ruvnetใช้กันมาก↓ 13.5K/สัปดาห์★ 81.5Kอัปเดต 14 เดือนที่ผ่านมา

รันบนเครื่อง
ติดตั้ง

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

โดย windmill-labsใช้กันมาก★ 18.5Kอัปเดต วันนี้

รันบนคลาวด์
ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Mailsnail

Open-source, provider-agnostic physical mail for AI agents.

Agents have every channel except one. They can email, text, call, and post to every feed — but until now, putting a real, postmarked envelope in a mailbox meant a human signing up for a print-provider account, provisioning API keys, and wiring billing. Mailsnail closes that gap:

  • Nothing to install. Add one URL to Claude, ChatGPT, Cursor or any MCP client and sign in. Pay for one letter by card or fund a balance, priced at our cost: from $1.21 first-class and $8.61 certified, no subscription. Agents that can mint a Stripe Shared Payment Token can also pay per piece with no account, over the Machine Payments Protocol (HTTP 402).
  • No lock-in, ever. The provider layer is open and swappable: bring your own Click2Mail or Lob account, self-host the whole gateway, or chain providers for failover. The managed service is a convenience, not a cage.
  • Built for compliance mail. Certified letters with extra_service: "certified" — the mail that legally *must* be physical (preliminary lien notices, legal notices) and must not miss its deadline because one print API had a bad day.
claude mcp add -t http mailsnail https://api.mailsnail.dev/mcp

then /mcp → mailsnail → Authenticate, and: "Mail a thank-you letter to my aunt."

In Claude Desktop or ChatGPT, add https://api.mailsnail.dev/mcp as a custom connector. Steps for every app: mailsnail.dev/setup. Running your own Click2Mail or Lob account instead? See Ways to run it.

Hosted connector and plugins

The quickest start needs no install. Add https://api.mailsnail.dev/mcp as a custom connector in Claude, ChatGPT, Cursor or any MCP client that supports remote servers, then sign in. Each app's setup steps are at mailsnail.dev/setup.

plugins/mailsnail packages that connector with skills for sending letters, sending certified mail and tracking mail. It works in Claude (chat, Cowork and Claude Code) and in Cursor. To install it in Claude Code:

/plugin marketplace add iancollins27/mailsnail

/plugin install mailsnail@mailsnail

Packages

PackageWhat it is
mailsnailMCP server — 11 tools (doctor, verify_address, preview_letter, send_letter, send_postcard, get_balance, top_up, get_letter, get_postcard, list_letters, cancel_letter) over any provider below. Works in Claude Code, Claude Desktop, Cursor, Codex CLI, OpenAI Agents SDK.
@mailsnail/coreProvider-agnostic core: adapters (Click2Mail, Lob, any Mailsnail gateway), multi-provider failover router, request validation. Zero dependencies.
@mailsnail/gatewaySelf-hostable REST API: BYO provider credentials, body_text→PDF rendering, proofs, invocation logging. The managed service at api.mailsnail.dev runs the same wire protocol.
spec/The provider-neutral mail-piece schema + the failover-safety contract. Implement it and anything — including a print shop — becomes a Mailsnail-compatible node.

Ways to run it

ModeCredentialsPayingGood for
hosted connector (api.mailsnail.dev/mcp)none; you sign inyou, per letter by card or from a balancepeople in Claude, ChatGPT, Cursor; zero-setup
managed (stdio default)noneagent, per piece (Stripe SPT)agents that can mint an SPT
gatewayyour own, on your serveryour provider accountteams; PII stays in your infra
click2mail / lob (BYOK)yours, local envyour provider accountdirect control, one provider
failover chainyours, per provideryour provider accountsmail that must not miss deadlines

Failover is deliberately conservative: a send moves to the next provider only when the failed provider guarantees nothing entered production and no money moved (safeToRetry — see the spec). A duplicate certified letter is worse than an error.

Running behind an egress proxy or allowlist

Sandboxed agents — CI runners, enterprise agent platforms, hosted agent sessions — usually sit behind an egress allowlist, and that is the environment managed mode is *for*. Two minutes of setup:

npx mailsnail doctor      # says exactly what it can and can't reach, and why. Free; never mails.

Allow this host:

ModeHost to permitPort
managed (default)api.mailsnail.dev443 (TCP / HTTPS CONNECT)
self-hosted gatewaywhatever MAIL_API_BASE_URL points atits port
click2mail (BYOK)rest.click2mail.com443
lob (BYOK)api.lob.com443

Allowlist by hostname, not IP: the managed gateway runs on managed infrastructure and its addresses change without notice. If your policy is IP-only, self-host @mailsnail/gateway on an address you control — that escape hatch is the whole point of the open provider layer.

Through an HTTP proxy. Node's fetch ignores HTTPS_PROXY unless you tell it not to, so an allowlisted gateway can still time out silently. Either:

export NODE_USE_ENV_PROXY=1        # Node >= 22.21

export HTTPS_PROXY=http://proxy.example:8080

or install undici alongside mailsnail (npm i undici) and Mailsnail routes through HTTPS_PROXY/HTTP_PROXY/ALL_PROXY itself, honoring NO_PROXY. mailsnail doctor tells you which of these is actually in effect.

TLS-inspecting proxy? Point NODE_EXTRA_CA_CERTS at your organization's CA bundle.

When it's blocked anyway, the failure says so instead of guessing: transport errors carry a code of unreachable, egress_blocked, or tls_untrusted, plus the exact host:port to permit. Any of those codes means the request never reached the backend — nothing mailed, nothing was charged, and the fix is network policy, not your account.

Safety

  • Dry-run by default everywhere; live mail requires an explicit MAIL_MCP_ALLOW_LIVE=1.
  • Per-session spend caps in the MCP server; auto-refund in managed mode when a paid piece fails to mail.
  • preview_letter returns a proof PDF and exact price before anything is charged — show it to your user first.
  • Don't use this for spam, harassment, or fraud. Provider terms and USPS regulations apply; managed mode enforces its own abuse screening.

Why open source

You're letting software put paper in mailboxes and spend money doing it. Read the code. Run it yourself with your own provider account for free. Use managed mode when you'd rather not hold credentials at all. If we ever disappoint you, MAIL_PROVIDER=click2mail and your mail keeps moving — that's the deal, and it's enforceable because this repo exists.

Status

Early. US-only today. Letters, certified letters, and postcards. The managed API, MCP server, self-host gateway, and Click2Mail/Lob adapters are live; additional adapters (PostGrid, Stannp) are next — CONTRIBUTING.md has the adapter guide if you want one sooner.

License

MIT.