# Publishing SolMail MCP - Complete Guide

This guide covers all distribution channels for SolMail MCP.

## 📦 NPM Publishing

### Prerequisites
```bash
# Create NPM account at https://www.npmjs.com
# Login to NPM
npm login
```

### Publish
```bash
cd ~/solmail-mcp

# Ensure build is fresh
npm run build

# Publish to NPM
npm publish
```

### Installation (for users)
```bash
# Global install
npm install -g solmail-mcp

# Then users configure in Claude Desktop:
{
  "mcpServers": {
    "solmail": {
      "command": "solmail-mcp",
      "env": {
        "SOLANA_PRIVATE_KEY": "your_key_here",
        "SOLANA_NETWORK": "devnet"
      }
    }
  }
}
```

### Updating Version
```bash
# Update version
npm version patch  # 1.0.0 → 1.0.1
npm version minor  # 1.0.0 → 1.1.0
npm version major  # 1.0.0 → 2.0.0

# Publish new version
npm publish
```

---

## 🏛️ Anthropic MCP Registry

### Submission Process

1. **Fork the MCP Registry**
   ```bash
   # Visit and fork
   open https://github.com/anthropics/mcp-registry

   # Clone your fork
   git clone https://github.com/YOUR_USERNAME/mcp-registry
   cd mcp-registry
   ```

2. **Add SolMail Entry**

   Create file: `servers/solmail.json`
   ```json
   {
     "name": "solmail",
     "displayName": "SolMail",
     "description": "Send physical mail with Solana cryptocurrency",
     "repository": "https://github.com/ExpertVagabond/solmail-mcp",
     "installation": {
       "npm": "solmail-mcp"
     },
     "configuration": {
       "command": "solmail-mcp",
       "env": {
         "SOLANA_PRIVATE_KEY": {
           "description": "Your agent's Solana wallet private key",
           "required": true
         },
         "SOLANA_NETWORK": {
           "description": "Network: devnet or mainnet-beta",
           "default": "devnet"
         }
       }
     }
   }
   ```

3. **Submit Pull Request**
   ```bash
   git add servers/solmail.json
   git commit -m "Add SolMail MCP server"
   git push origin main

   # Create PR on GitHub
   open https://github.com/anthropics/mcp-registry/compare
   ```

4. **PR Description Template**
   ```markdown
   # Add SolMail MCP Server

   **Name**: SolMail
   **Category**: Communication / Physical World
   **Repository**: https://github.com/ExpertVagabond/solmail-mcp

   ## Description
   SolMail enables AI agents to send real physical letters and postcards worldwide,
   paid for with Solana cryptocurrency. First AI-to-physical-mail bridge.

   ## Features
   - Send real mail to 200+ countries
   - Pay with SOL (devnet or mainnet)
   - Non-custodial wallet control
   - Production-ready infrastructure (Lob.com)

   ## Installation
   ```bash
   npm install -g solmail-mcp
   ```

   ## Testing
   Tested with Claude Desktop on macOS. Demo: https://solmail.online

   ## License
   MIT
   ```

---

## 🌐 Smithery Publishing

### Option 1: Direct HTTP Server (Recommended)

1. **Deploy HTTP Server**
   ```bash
   # See HTTP_DEPLOYMENT.md for full guide
   cd ~/solmail-mcp
   railway up  # or render/fly.io
   ```

2. **Publish to Smithery**
   - Go to: https://smithery.ai/new
   - **Namespace**: `solmail`
   - **Server ID**: `solmail-mcp`
   - **MCP Server URL**: `https://your-deployment.railway.app/mcp`
   - Click **Continue** → **Publish**

### Option 2: NPM Reference

If Smithery supports NPM-based MCP servers:
- **Installation Method**: npm
- **Package Name**: `solmail-mcp`
- **Command**: `solmail-mcp`

---

## 📢 Community Promotion

### GitHub
```bash
# Add topic tags to repo
gh repo edit --add-topic mcp,solana,mail,ai-agent,model-context-protocol

# Create release
gh release create v1.0.0 --title "SolMail MCP v1.0.0" --notes "Initial release"
```

### Social Media

**Twitter/X**:
```
🚀 Just published SolMail MCP!

AI agents can now send REAL physical mail using Solana cryptocurrency.

✅ 200+ countries
✅ ~$1.50 per letter
✅ 400ms Solana finality
✅ Production-ready

Try it: npm install -g solmail-mcp

#Solana #AI #MCP
```

**Reddit** (r/solana, r/ClaudeAI):
```markdown
## SolMail MCP: Send Physical Mail from AI Agents

I built an MCP server that lets AI agents like Claude send real physical letters,
paid for with Solana.

**Use Cases**:
- AI customer service sending thank-you notes
- Automated birthday cards
- Physical receipts for on-chain transactions

**Try it**: `npm install -g solmail-mcp`

[GitHub](https://github.com/ExpertVagabond/solmail-mcp) | [Demo](https://solmail.online)
```

### Colosseum Hackathon

✅ Already submitted!
- Agent: #74 (solmail-agent)
- Project: #35 (SolMail)
- Status: Submitted

---

## 📊 Distribution Status

| Channel | Status | URL |
|---------|--------|-----|
| **NPM** | ⏳ Ready to publish | `npm publish` |
| **MCP Registry** | ⏳ PR needed | [Fork & submit](https://github.com/anthropics/mcp-registry) |
| **Smithery** | ⏳ Deploy HTTP server | [Deploy guide](./HTTP_DEPLOYMENT.md) |
| **GitHub** | ✅ Published | https://github.com/ExpertVagabond/solmail-mcp |
| **Colosseum** | ✅ Submitted | Agent #74, Project #35 |

---

## 🎯 Next Steps

1. **Immediate**: `npm login && npm publish`
2. **This Week**: Submit to MCP Registry
3. **Optional**: Deploy HTTP server for Smithery
4. **Ongoing**: Community engagement & promotion

---

**Questions?**
- Email: hello@solmail.online
- GitHub Issues: https://github.com/ExpertVagabond/solmail-mcp/issues
- Twitter: @expertvagabond