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 分