English Français العربية

io.github.ExpertVagabond/solmail

Registre officiel Finance et paiements

Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide

Code source Documentation

Que pouvez-vous faire avec io.github.ExpertVagabond/solmail ?

  • 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package solmail-mcp
Claude Code 
claude mcp add solmail -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_NETWORK=<SOLANA_NETWORK>' -e 'SOLMAIL_API_URL=<SOLMAIL_API_URL>' -e 'MERCHANT_WALLET=<MERCHANT_WALLET>' -- npx -y solmail-mcp@1.0.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "solmail": {
            "command": "npx",
            "args": [
                "-y",
                "solmail-mcp@1.0.2"
            ],
            "env": {
                "SOLANA_PRIVATE_KEY": "<your solana_private_key>",
                "SOLANA_NETWORK": "<SOLANA_NETWORK>",
                "SOLMAIL_API_URL": "<SOLMAIL_API_URL>",
                "MERCHANT_WALLET": "<MERCHANT_WALLET>"
            }
        }
    }
}

Variables d'environnement

  • SOLANA_PRIVATE_KEY obligatoire secret Your agent's Solana wallet private key (base58 or JSON array format)
  • SOLANA_NETWORK Solana network: devnet for testing, mainnet-beta for production
  • SOLMAIL_API_URL SolMail API endpoint
  • MERCHANT_WALLET Merchant wallet address for payments

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. :mailbox_with_mail: solmail-mcp
  2. Install
  3. Features
  4. Tools (4)
  5. Usage Example
  6. How It Works
  7. Pricing
  8. Configuration
  9. Development
  10. Related Projects
  11. Contributing
  12. Links
  13. License

: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)

ToolDescription
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

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

TypePriceSOL (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

VariableRequiredDescription
SOLANA_PRIVATE_KEYYesAgent wallet private key (base58)
SOLANA_NETWORKNodevnet (default) or mainnet-beta
SOLMAIL_API_URLNoAPI endpoint (default: https://solmail.online/api)
MERCHANT_WALLETNoCustom 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

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/my-feature)
  3. Commit your changes
  4. Open a Pull Request

License

MIT -- Purple Squirrel Media

Questions fréquentes

Qu'est-ce que io.github.ExpertVagabond/solmail ?

Send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide

Comment installer io.github.ExpertVagabond/solmail ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add solmail -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'SOLANA_NETWORK=<SOLANA_NETWORK>' -e 'SOLMAIL_API_URL=<SOLMAIL_API_URL>' -e 'MERCHANT_WALLET=<MERCHANT_WALLET>' -- npx -y solmail-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ExpertVagabond/solmail ?

Oui. Il attend SOLANA_PRIVATE_KEY, à renseigner dans sa configuration.

io.github.ExpertVagabond/solmail est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ExpertVagabond/solmail ?

Il est publié par ExpertVagabond. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.