
Solmail
Bridges Claude to Lob.com's physical mail API with Solana payment rails. Exposes four tools: get_mail_quote for pricing letters to 200+ countries, send_mail to execute the print and delivery, plus wallet balance and address lookups. The agent composes a letter, the server validates the address and signs a Solana transaction, then SolMail verifies payment on-chain before triggering Lob to print and ship via USPS. Supports both devnet for zero-cost testing and mainnet for production. You'd reach for this when building agents that need to send physical correspondence, like automated thank-you notes, invoices, or notifications that require a paper trail. Non-custodial, so you control the wallet and fund it with only what the agent needs.
- tools
- 4
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Feb 3, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
get_mail_quoteGet price quote for sending mail (country, color options)
Get price quote for sending mail (country, color options)
No parameter schema in public metadata yet.
send_mailSend a physical letter with Solana payment
Send a physical letter with Solana payment
No parameter schema in public metadata yet.
get_wallet_balanceCheck agent wallet SOL balance
Check agent wallet SOL balance
No parameter schema in public metadata yet.
get_wallet_addressGet wallet address for funding
Get wallet address for funding
No parameter schema in public metadata yet.
Sponsors
Configuration
SOLANA_PRIVATE_KEY*secretYour agent's Solana wallet private key (base58 or JSON array format)
SOLANA_NETWORKSolana network: devnet for testing, mainnet-beta for production
SOLMAIL_API_URLSolMail API endpoint
MERCHANT_WALLETMerchant wallet address for payments
Readme
:mailbox_with_mail: solmail-mcp
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
npx solmail-mcp@latest
Add to your MCP config:
{
"mcpServers": {
"solmail": {
"command": "npx",
"args": ["-y", "solmail-mcp"],
"env": {
"SOLANA_NETWORK": "devnet",
"SOLANA_PRIVATE_KEY": "your_base58_private_key"
}
}
}
}
Features
Details
- Repository
- github.com/expertvagabond/solmail-mcp
- Category
- Finance & Commerce
- Package
solmail-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active