Back to Browse
Free
Server data from the Official MCP Registry
Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide
About
Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide
Security Report
7.0
Moderate7.0Low RiskValid MCP server (3 strong, 7 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Your agent's Solana wallet private key (base58 or JSON array format)Required
Environment variable: SOLANA_PRIVATE_KEY
Solana network: devnet for testing, mainnet-beta for production
Environment variable: SOLANA_NETWORK
SolMail API endpoint
Environment variable: SOLMAIL_API_URL
Merchant wallet address for payments
Environment variable: MERCHANT_WALLET
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-expertvagabond-solmail": {
"env": {
"SOLANA_NETWORK": "your-solana-network-here",
"MERCHANT_WALLET": "your-merchant-wallet-here",
"SOLMAIL_API_URL": "your-solmail-api-url-here",
"SOLANA_PRIVATE_KEY": "your-solana-private-key-here"
},
"args": [
"-y",
"solmail-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
- 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
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
| 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
npm install && npm run build
npm run dev # Watch mode
npm start # Production
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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
3
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
404
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
89.9K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local