# Quick Publish Guide - Do This Now! 🚀

Three commands to publish SolMail MCP everywhere.

---

## 1️⃣ NPM (5 minutes)

```bash
# Login to NPM (one-time setup)
npm login
# Follow prompts: username, password, email

# Publish!
cd ~/solmail-mcp
npm publish

# ✅ Done! Users can now: npm install -g solmail-mcp
```

**Verify**: Visit https://www.npmjs.com/package/solmail-mcp

---

## 2️⃣ Anthropic MCP Registry (10 minutes)

```bash
# Fork and clone registry
open https://github.com/anthropics/mcp-registry
# Click "Fork" button

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

# Copy prepared submission
cp ~/solmail-mcp/mcp-registry-submission.json servers/solmail.json

# Commit and push
git add servers/solmail.json
git commit -m "Add SolMail MCP server"
git push origin main

# Create PR
open https://github.com/anthropics/mcp-registry/compare
# Click "Create Pull Request"
# Title: "Add SolMail MCP Server"
# Description: "AI agents can send physical mail with Solana cryptocurrency"
# Click "Create Pull Request"
```

**Verify**: Watch for PR approval at https://github.com/anthropics/mcp-registry/pulls

---

## 3️⃣ Smithery (15 minutes)

### Deploy HTTP Server

**Option A - Railway (Easiest)**:
```bash
# Install Railway CLI
npm install -g @railway/cli

# Login
railway login

# Initialize project
cd ~/solmail-mcp
railway init

# Deploy
railway up

# Get URL
railway domain
# Copy the URL: https://solmail-mcp-production.up.railway.app
```

**Option B - Render**:
1. Go to https://render.com/deploy
2. Connect GitHub: `https://github.com/ExpertVagabond/solmail-mcp`
3. Settings:
   - Build: `npm install && npm run build`
   - Start: `node dist/http-server.js`
   - Add env vars:
     - `PORT=3001`
     - `SOLMAIL_API_URL=https://solmail.online/api`
     - `MERCHANT_WALLET=B5daxcMG9LgcXkZwuxBhHtuYxzG9J4ekgz1wUiMXw3xp`
4. Click "Deploy"
5. Copy URL: `https://solmail-mcp.onrender.com`

### Publish to Smithery

1. Go to https://smithery.ai/new
2. Fill in:
   - **Namespace**: `solmail`
   - **Server ID**: `solmail-mcp`
   - **MCP Server URL**: `https://YOUR-DEPLOYMENT-URL.com/mcp`
3. Click **Continue**
4. Test connection
5. Click **Publish**

**Verify**: Visit https://smithery.ai/server/solmail/solmail-mcp

---

## ✅ Checklist

After publishing, verify:

- [ ] NPM package live: `npm info solmail-mcp`
- [ ] MCP Registry PR created
- [ ] HTTP server deployed and responding: `curl https://YOUR-URL.com/health`
- [ ] Smithery listing published

---

## 📊 Distribution Complete!

Once all three are done, SolMail MCP will be available:

1. **NPM**: Direct install for Claude Desktop users
2. **MCP Registry**: Listed in official Anthropic registry
3. **Smithery**: Available to 10,000+ Smithery users

---

## 🎯 Post-Publishing

Update your project submission:

```bash
# Add distribution links to hackathon project
curl -X PUT https://agents.colosseum.com/api/my-project \
  -H "Authorization: Bearer 3853034c0a8ddbac6deb9e77270cf389fc0c445e75e13b5ae7ba57aa4c9c5ecb" \
  -H "Content-Type: application/json" \
  -d '{
    "additionalLinks": [
      {"title": "NPM Package", "url": "https://www.npmjs.com/package/solmail-mcp"},
      {"title": "Smithery Listing", "url": "https://smithery.ai/server/solmail/solmail-mcp"}
    ]
  }'
```

---

## Need Help?

- **NPM Issues**: See PUBLISHING.md section "NPM Publishing"
- **Deployment Issues**: See HTTP_DEPLOYMENT.md
- **Registry Issues**: Check https://github.com/anthropics/mcp-registry/blob/main/CONTRIBUTING.md

---

**Let's make SolMail MCP available to the world! 🌍**