1. Conduid
  2. Blockchain
  3. io.github.ExpertVagabond/solmail
MCP server · Blockchain

io.github.ExpertVagabond/solmail

by · github.com/ExpertVagabond/solmail-mcp

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

Unclaimed blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.ExpertVagabond/solmail

io.github.ExpertVagabond/solmail is an MCP server published by ExpertVagabond in the Blockchain category: send physical mail with Solana cryptocurrency - AI agents can send real letters worldwide.

The repository has 1 stars and 1 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-expertvagabond-solmail -- npx -y solmail-mcp
npx
npx -y solmail-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

get_mail_quoteGet price quote for sending mail (country, color options)

Parameters not published.

get_wallet_addressGet wallet address for funding

Parameters not published.

get_wallet_balanceCheck agent wallet SOL balance

Parameters not published.

send_mailSend a physical letter with Solana payment

Parameters not published.

Ask AI

✦

Ask AI about io.github.ExpertVagabond/solmail

Powered by Claude · Grounded in docs

I know everything about io.github.ExpertVagabond/solmail. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

:mailbox_with_mail: solmail-mcp

npm version 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)

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

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.ExpertVagabond/solmail

How do I install io.github.ExpertVagabond/solmail?

Run claude mcp add io-github-expertvagabond-solmail -- npx -y solmail-mcp, then add the server to your MCP client's configuration.

Is io.github.ExpertVagabond/solmail safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.ExpertVagabond/solmail still maintained?

Yes — the last commit was a month ago. The repository has 1 stars and 1 forks.