SolMail

You can run and integrate SolMail MCP to let AI agents pay for and send real letters and postcards using Solana cryptocurrency. This MCP server connects your AI workflows to a physical mail fulfillment network, enabling automated, wallet-backed mail sending with global delivery and transparent on-chain payments.

How to use

You will run the MCP server locally or in your environment and connect your AI agent to it. The server exposes a simple interface to quote mail costs, send mail, and query wallet balances and addresses. Your agent composes letter content and recipient details, requests a price quote, authorizes the payment from the agent wallet, and then triggers printing and mailing through the fulfillment partner. You can script or prompt your agent to perform these steps automatically for autonomous communications, marketing mailings, reminders, or personal assistant tasks.

How to install

Prerequisites you need before installation:

• Node.js and npm installed on your system
• Git to clone repositories
• Solana CLI for wallet management and network interactions

Install and run the MCP server following these concrete steps:

# Clone or create the project
git clone <repository-url>
cd solmail-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

# Start the server (stdio runtime)
npm start

Configuration and runtime notes

Configure the client with the agent’s Solana wallet and API URL. You will run the server with environment variables that specify the API endpoint, the Solana network, and the agent wallet private key.

# Example environment file
SOLMAIL_API_URL=https://solmail.online/api
SOLANA_NETWORK=devnet
SOLANA_PRIVATE_KEY=your_base58_private_key_here
MERCHANT_WALLET=<merchant_solana_address>

Security and best practices

• Use a dedicated wallet for your AI agent with limited funds to minimize risk.
• Safeguard the private key and avoid committing it to code repositories.
• Thoroughly test on a devnet or test environment before using mainnet funds.
• Consider rate limiting and content review to prevent unintended mailings.

Production deployment tips

When ready for real mail, ensure you are in production mode by configuring live API keys and mainnet settings. Validate that the Lob integration and payment flow function correctly in a controlled test.

Usage examples with the MCP endpoints

The MCP server provides endpoints to quote, send, and check wallet information. Your AI agent can call these endpoints to obtain price estimates, trigger mail sending, and verify payments. Use the endpoints to automate workflows such as autonomous customer service, AI-driven marketing, and smart contract-triggered mail.

Troubleshooting tips

If the server cannot verify a payment, check that the agent wallet holds sufficient SOL and that the correct network is selected. Ensure the recipient address is valid and that the fulfillment partner is accessible. Review environment variable configurations for correctness.

Available tools

get_mail_quote

Fetch a price quote for sending mail to a specific country with color options and delivery estimates.

send_mail

Send physical mail by providing letter content, recipient address, and mail options; includes payment flow.

get_wallet_balance

Check the agent wallet balance to ensure sufficient funds for mailings.

get_wallet_address

Retrieve the agent wallet address to fund or verify funds.