mcpField
S
solmail

solmail

Local
github.com/ExpertVagabondCommunication1Updated 9w ago
Repository

About solmail

solmail is an MCP server for AI agents to send physical letters and postcards to real addresses worldwide, paying with Solana. It provides tools for quotes, mail delivery, and wallet details, with devnet testing and mainnet-beta support.

Key features

  1. 01Send physical mail worldwide
  2. 02Pay mailing costs with SOL
  3. 03Request mailing quotes
  4. 04Check wallet balance and address
  5. 05Test with devnet

Use cases

  1. 01Have an agent send a physical thank-you letter
  2. 02Pay for international postcard delivery with SOL
  3. 03Test mail-sending flows on devnet

MCP support

The MCP server exposes four tools for quotes, sending mail, wallet balances, and wallet addresses, enabling AI agents to arrange physical mail and pay with Solana.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "expertvagabond-solmail": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
        "SOLANA_NETWORK": "<SOLANA_NETWORK>",
        "SOLMAIL_API_URL": "<SOLMAIL_API_URL>",
        "MERCHANT_WALLET": "<MERCHANT_WALLET>"
      }
    }
  }
}
Run commandnpx -y solmail-mcp
Environment variables to set
SOLANA_PRIVATE_KEYSecretYour agent's Solana wallet private key (base58 or JSON array format)
SOLANA_NETWORKSolana network: devnet for testing, mainnet-beta for production
SOLMAIL_API_URLSolMail API endpoint
MERCHANT_WALLETMerchant wallet address for payments

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmsolmail-mcp1.0.2

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
colorbooleanNoWhether to print in color. Adds $0.50 to price.
countrystringNoDestination country code (e.g., US, GB, CA). Defaults to US.

Details

From the project README

:mailbox_with_mail: solmail-mcp

npm version License: MIT GitHub stars Solana

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

Related Projects

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

Links

License

MIT -- Purple Squirrel Media

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.