solanacryptocurrencyphysical-mailblockchaincommunication
Send physical letters and postcards worldwide paid with Solana cryptocurrency via AI agents.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Compose and send physical letters via AI agents
Get price quotes for mailing letters or postcards
Pay for mailings using Solana cryptocurrency
Check Solana wallet balance for funding
Retrieve wallet address for receiving SOL
Key features
Print and mail letters to 200+ countries via Lob.com
Make payments with SOL on devnet or mainnet
Non-custodial wallet control with private key
AI-native design for Model Context Protocol integration
Demo mode with devnet SOL and Lob test API
Capabilities & Tool Schemas (4)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Solmail MCP.
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
Documentation Overview
: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
Add to your MCP config:
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)
| 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 |
Usage Example
How It Works
Pricing
| 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 |
Configuration
| 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.
Development
Related 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
License
MIT -- Purple Squirrel Media
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
1
Stargazers on the source repository.
Last commit
4d ago
Most recent push to the default branch.
Tools exposed
4
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Solmail MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/expertvagabond-solmail-mcp)HTML Embed
<a href="https://allmcps.com/mcp/expertvagabond-solmail-mcp"><img src="https://allmcps.com/api/badge/expertvagabond-solmail-mcp?style=directory" alt="Solmail MCP on AllMCPs" /></a>