{
  "markdown": "# :mailbox_with_mail: solmail-mcp\n\n[![npm version](https://img.shields.io/npm/v/solmail-mcp.svg)](https://www.npmjs.com/package/solmail-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub stars](https://img.shields.io/github/stars/ExpertVagabond/solmail-mcp)](https://github.com/ExpertVagabond/solmail-mcp/stargazers)\n[![Solana](https://img.shields.io/badge/Solana-14F195?logo=solana&logoColor=white)](https://solana.com)\n\n**Send real physical mail using Solana cryptocurrency from your AI agent.** A [Model Context Protocol](https://modelcontextprotocol.io) 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).\n\n## Install\n\n```bash\nnpx solmail-mcp@latest\n```\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"solmail\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"solmail-mcp\"],\n      \"env\": {\n        \"SOLANA_NETWORK\": \"devnet\",\n        \"SOLANA_PRIVATE_KEY\": \"your_base58_private_key\"\n      }\n    }\n  }\n}\n```\n\n## Features\n\n- **Physical Mail** -- Letters printed and mailed to 200+ countries via Lob.com\n- **Solana Payments** -- Pay with SOL on devnet (testing) or mainnet (production)\n- **Non-Custodial** -- Direct wallet control, no intermediaries\n- **AI-Native** -- Built specifically for MCP agent integration\n- **Demo Mode** -- Test with devnet SOL and Lob test API at zero cost\n\n## Tools (4)\n\n| Tool | Description |\n|------|-------------|\n| `get_mail_quote` | Get price quote for sending mail (country, color options) |\n| `send_mail` | Send a physical letter with Solana payment |\n| `get_wallet_balance` | Check agent wallet SOL balance |\n| `get_wallet_address` | Get wallet address for funding |\n\n## Usage Example\n\n```\nYou: Send a thank you note to John Doe at 123 Main St, San Francisco, CA 94102\n\nClaude: [calls get_mail_quote] Cost: $1.50 (~0.015 SOL) for domestic US mail\n        [calls send_mail] Letter sent!\n          Letter ID: ltr_abc123\n          Tracking: 9400000000000000000000\n          Payment: 0.015 SOL (tx: 5j7s...)\n          Delivery: 3-5 business days\n```\n\n## How It Works\n\n```\nAgent composes letter --> MCP validates address --> Solana tx signed\n    --> Payment sent to merchant --> SolMail verifies on-chain\n    --> Lob.com prints letter --> USPS delivers --> Tracking returned\n```\n\n## Pricing\n\n| Type | Price | SOL (at $100/SOL) |\n|------|-------|-------------------|\n| US Domestic | $1.50 | ~0.015 SOL |\n| International | $2.50 | ~0.025 SOL |\n| Color printing | +$0.50 | +0.005 SOL |\n| Solana tx fee | ~$0.00025 | ~0.0000025 SOL |\n\n## Configuration\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `SOLANA_PRIVATE_KEY` | Yes | Agent wallet private key (base58) |\n| `SOLANA_NETWORK` | No | `devnet` (default) or `mainnet-beta` |\n| `SOLMAIL_API_URL` | No | API endpoint (default: `https://solmail.online/api`) |\n| `MERCHANT_WALLET` | No | Custom payment destination |\n\n**Important**: Create a dedicated wallet with limited funds for AI agents. Never use your primary wallet.\n\n## Development\n\n```bash\nnpm install && npm run build\nnpm run dev    # Watch mode\nnpm start      # Production\n```\n\n## Related Projects\n\n- [solana-mcp-server-app](https://github.com/ExpertVagabond/solana-mcp-server-app) -- Solana wallet + DeFi MCP\n- [coldstar-colosseum](https://github.com/ExpertVagabond/coldstar-colosseum) -- Air-gapped Solana vault\n- [ordinals-mcp](https://github.com/ExpertVagabond/ordinals-mcp) -- Bitcoin Ordinals MCP server\n- [cpanel-mcp](https://github.com/ExpertVagabond/cpanel-mcp) -- cPanel hosting MCP server\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/my-feature`)\n3. Commit your changes\n4. Open a Pull Request\n\n## Links\n\n- [Website](https://solmail.online) | [npm](https://www.npmjs.com/package/solmail-mcp) | [MCP Docs](https://modelcontextprotocol.io)\n\n## License\n\nMIT -- [Purple Squirrel Media](https://github.com/ExpertVagabond)\n",
  "bytes": 4057,
  "sha": "7eef96d00f4bec45134a86103238ebc8823786172fb51ee8b2d3c51ccdd2f2a6",
  "repo_slug": "expertvagabond/solmail-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_expertvagabond_solmail_1d05dfac/readme"
}