Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"solmail": {
"env": {
"SOLANA_NETWORK": "devnet",
"SOLANA_PRIVATE_KEY": "your_base58_private_key"
},
"args": [
"-y",
"solmail-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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).
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'solmail-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked solmail-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in communication / finance
An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
MCP server for Kaseya Autotask PSA — 39 tools for companies, tickets, projects, time entries, and more
MCP Security Weekly
Get CVE alerts and security updates for io.github.ExpertVagabond/solmail and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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).
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"
}
}
}
}
| Tool | Description |
|---|---|
get_mail_quote | Get price quote for sending mail (country, color options) |
send_mail | Send a physical letter with Solana payment |
get_wallet_balance | Check agent wallet SOL balance |
get_wallet_address | Get wallet address for funding |
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
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
| Type | Price | SOL (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 |
| Variable | Required | Description |
|---|---|---|
SOLANA_PRIVATE_KEY | Yes | Agent wallet private key (base58) |
SOLANA_NETWORK | No | devnet (default) or mainnet-beta |
SOLMAIL_API_URL | No | API endpoint (default: https://solmail.online/api) |
MERCHANT_WALLET | No | Custom payment destination |
Important: Create a dedicated wallet with limited funds for AI agents. Never use your primary wallet.
npm install && npm run build
npm run dev # Watch mode
npm start # Production
git checkout -b feature/my-feature)MIT -- [P