Solmail

io.github.ExpertVagabond由 GitHub 帳號 ExpertVagabond 發布v1.0.2更新於 Oct 24, 2026

Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

讓助理報價並寄送真實的實體信件與明信片到世界各地，並以代理錢包中的 Solana 加密貨幣付款。

可以做什麼
Solmail 提供四個工具：get_mail_quote 依國家與顏色選項查詢價格，send_mail 以 SOL 付款並寄出實體信件，get_wallet_balance 查詢代理錢包的 SOL 餘額，get_wallet_address 取得可用於儲值的錢包地址。信件透過 Lob.com 列印並寄往 200 多個國家的地址，並回傳追蹤編號與交易參考。devnet 示範模式可用測試 SOL 與 Lob 測試 API 零成本試用。
適用情境
當助理需要寄送實體郵件（例如感謝函、通知或行銷信件）到真實郵寄地址，並按件以 SOL 付款時使用。它適合已持有 Solana 錢包、希望取得可追蹤的實體投遞而非電子郵件或數位訊息的代理工作流程。
執行需求
以 npm 套件（npx solmail-mcp）透過 stdio 在使用者本機執行，需要 Node.js。必須設定環境變數 SOLANA_PRIVATE_KEY，存放代理錢包的私鑰；SOLANA_NETWORK 選擇 devnet（預設）或 mainnet-beta，SOLMAIL_API_URL 與 MERCHANT_WALLET 為選用。需要連線至 SolMail API 與 Solana 網路的網路存取，錢包中需有 SOL。
安裝前請注意
此伺服器需要 SOLANA_PRIVATE_KEY（錢包私鑰），請使用資金有限的專用錢包，切勿使用主要錢包。在 mainnet-beta 上，send_mail 每封信都會花費真實 SOL，國內約 1.50 美元、國際約 2.50 美元，另加彩色列印與交易費用。寄信會提交付款交易，並將收件人的郵寄地址與信件內容提供給 SolMail 服務及 Lob.com 用於列印與投遞。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Solmail，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

:mailbox_with_mail: solmail-mcp

[npm version] [License: MIT] [GitHub stars] [Solana]

Send real physical mail using Solana cryptocurrency from your AI agent. A Model Context Protocol server that enables Claude and other AI agents to send physical letters and postcards to real addresses worldwide, paid with SOL. Built for the Colosseum Agent Hackathon (#47).

Install

bash
npx solmail-mcp@latest

Add to your MCP config:

json
{  "mcpServers": {    "solmail": {      "command": "npx",      "args": ["-y", "solmail-mcp"],      "env": {        "SOLANA_NETWORK": "devnet",        "SOLANA_PRIVATE_KEY": "your_base58_private_key"      }    }  }}

Features

  • Physical Mail -- Letters printed and mailed to 200+ countries via Lob.com
  • Solana Payments -- Pay with SOL on devnet (testing) or mainnet (production)
  • Non-Custodial -- Direct wallet control, no intermediaries
  • AI-Native -- Built specifically for MCP agent integration
  • Demo Mode -- Test with devnet SOL and Lob test API at zero cost

Tools (4)

ToolDescription
get_mail_quoteGet price quote for sending mail (country, color options)
send_mailSend a physical letter with Solana payment
get_wallet_balanceCheck agent wallet SOL balance
get_wallet_addressGet wallet address for funding

Usage Example

You: Send a thank you note to John Doe at 123 Main St, San Francisco, CA 94102
Claude: [calls get_mail_quote] Cost: $1.50 (~0.015 SOL) for domestic US mail        [calls send_mail] Letter sent!          Letter ID: ltr_abc123          Tracking: 9400000000000000000000          Payment: 0.015 SOL (tx: 5j7s...)          Delivery: 3-5 business days

How It Works

Agent composes letter --> MCP validates address --> Solana tx signed    --> Payment sent to merchant --> SolMail verifies on-chain    --> Lob.com prints letter --> USPS delivers --> Tracking returned

Pricing

TypePriceSOL (at $100/SOL)
US Domestic$1.50~0.015 SOL
International$2.50~0.025 SOL
Color printing+$0.50+0.005 SOL
Solana tx fee~$0.00025~0.0000025 SOL

Configuration

VariableRequiredDescription
SOLANA_PRIVATE_KEYYesAgent wallet private key (base58)
SOLANA_NETWORKNodevnet (default) or mainnet-beta
SOLMAIL_API_URLNoAPI endpoint (default: https://solmail.online/api)
MERCHANT_WALLETNoCustom payment destination

Important: Create a dedicated wallet with limited funds for AI agents. Never use your primary wallet.

Development

bash
npm install && npm run buildnpm run dev    # Watch modenpm start      # Production

Related Projects

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/my-feature)
  3. Commit your changes
  4. Open a Pull Request

Links

License

MIT -- Purple Squirrel Media

來源：README.md，提交 990a8ab

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分