solmail-mcp

[](https://www.npmjs.com/package/solmail-mcp) [](https://opensource.org/licenses/MIT) [](https://github.com/ExpertVagabond/solmail-mcp/stargazers) [](https://solana.com)

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"
      }
    }
  }
}

• 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

| 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
        [