Solmail MCP server
Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide
1 stars35 downloads/wk
Reviews
Write oneNobody has reviewed Solmail yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Solmail tools (4, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_mail_quoteGet a price quote for sending mail
get_wallet_addressGet wallet address
get_wallet_balanceGet wallet SOL balance
send_mailwrite actionSend physical mail using Solana cryptocurrency
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 20 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Solmail compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 4
- the typical server has 7
- Tools that change things
- 25%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 35
- more than 25% of 12,191 servers with a package
What its tools let an agent do: 3 read · 1 send or post
Install Solmail in Claude Code, Cursor or VS Code
Runs npx -y solmail-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add solmail -- npx -y solmail-mcp
What the publisher says
From the Solmail repository's README, as published. We do not edit it. Read it on GitHub
:mailboxwithmail: 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@latestAdd to your MCP config:
{
"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)
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 daysHow 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 returnedPricing
Configuration
Important: Create a dedicated wallet with limited funds for AI agents. Never use your primary wallet.
Development
npm install && npm run build
npm run dev # Watch mode
npm start # ProductionRelated Projects
- solana-mcp-server-app -- Solana wallet + DeFi MCP
- coldstar-colosseum -- Air-gapped Solana vault
- ordinals-mcp -- Bitcoin Ordinals MCP server
- cpanel-mcp -- cPanel hosting MCP server
Contributing
- Fork the repository
- Create your feature branch (git checkout -b feature/my-feature)
- Commit your changes
- Open a Pull Request
Links
- Website | npm | MCP Docs
License
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Solmail: common questions
- Is Solmail MCP server safe?
- Mostly: it is graded B (83/100). Read the Solmail safety report
- How do I install Solmail?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Solmail need an API key?
- Yes. The registry entry asks for
SOLANA_PRIVATE_KEY. - Is Solmail maintained?
- The last commit was 57 days ago (2026-09-08). The latest release is v1.0.2.
- How does Solmail compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.