expertvagabond avatar

Solmail

expertvagabond/solmail-mcp

Bridges Claude to Lob.com's physical mail API with Solana payment rails. Exposes four tools: get_mail_quote for pricing letters to 200+ countries, send_mail to execute the print and delivery, plus wallet balance and address lookups. The agent composes a letter, the server validates the address and signs a Solana transaction, then SolMail verifies payment on-chain before triggering Lob to print and ship via USPS. Supports both devnet for zero-cost testing and mainnet for production. You'd reach for this when building agents that need to send physical correspondence, like automated thank-you notes, invoices, or notifications that require a paper trail. Non-custodial, so you control the wallet and fund it with only what the agent needs.

tools
4
auth
Secret needed
transport
STDIO
env vars
4
last updated
Feb 3, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

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

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

No parameter schema in public metadata yet.

send_mailSend a physical letter with Solana payment

Send a physical letter with Solana payment

No parameter schema in public metadata yet.

get_wallet_balanceCheck agent wallet SOL balance

Check agent wallet SOL balance

No parameter schema in public metadata yet.

get_wallet_addressGet wallet address for funding

Get wallet address for funding

No parameter schema in public metadata yet.

Sponsors

Configuration

SOLANA_PRIVATE_KEY*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

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


View the full README on GitHub

Details

Repository
github.com/expertvagabond/solmail-mcp
Category
Finance & Commerce
Package
solmail-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from expertvagabond

Related Finance & Commerce MCP servers

View all
1fernsugi avatarX402 Apifernsugi/x402-api-mcp-serverEight paid DeFi tools: prices, gas, swaps, token security, holders, yields, funding and wallets0stars
2giskard09 avatarGiskard Oasisgiskard09/giskard-oasisContextual guidance for AI agents in fog states. Claude-backed, Ed25519, Lightning payment.0stars
3giskard09 avatarGiskard Searchgiskard09/giskard-searchPay-per-use web search for AI agents. Lightning invoice, Ed25519 signature, karma discounts.0stars
4incwo avatarIncwo MCPio.github.incwo/incwoSecure MCP server for exploring incwo CRM data, documents, and email workflows.0stars
5joinquantish avatarPolymarket MCP Serverjoinquantish/polymarket-mcpSelf-hosted MCP server for AI agent trading on Polymarket prediction markets0stars
6bankee-ai avatarInferventis — Financial Data, News & Web MCPbankee-ai/inferventis-toolsLive financial data MCP: FX, crypto, stocks, news, URL reader. x402 on Base: $0.001/call.0stars