ugarapi-mcp-server 1.1.0

package/DEPLOYMENT_GUIDE.md

@@ -0,0 +1,343 @@
+# AgentHub - Complete Deployment Guide
+
+## 🚀 Quick Start (Non-Technical Setup)
+
+This guide will get your AI service business live in 4 hours, even with zero coding experience.
+
+---
+
+## Step 1: Get Your Domain (15 minutes)
+
+1. Go to **Namecheap.com**
+2. Search for a domain like: `agenthub.ai`, `aiservices.io`, or `botapi.com`
+3. Purchase (.com or .io recommended) - Cost: ~$12/year
+4. Don't buy any add-ons, just the domain
+
+**Your domain:** `ugarapi.com` ✅
+
+---
+
+## Step 2: Set Up Hosting (20 minutes)
+
+### Option A: Railway.app (Recommended - Easiest)
+
+1. Go to **railway.app**
+2. Click "Start a New Project"
+3. Sign up with GitHub (create free GitHub account if needed)
+4. Click "Deploy from GitHub repo"
+5. Click "Deploy from Template"
+6. We'll upload code in Step 4
+
+**Cost:** $5/month (includes $5 free credit to start)
+
+### Option B: Render.com (Alternative)
+
+1. Go to **render.com**
+2. Sign up (free)
+3. Click "New +" → "Web Service"
+4. We'll connect GitHub in Step 4
+
+**Cost:** $7/month for starter tier
+
+---
+
+## Step 3: Bitcoin Lightning Setup (30 minutes)
+
+You need to accept Bitcoin Lightning payments. Here's the easiest way:
+
+### Use BTCPay Server (Hosted)
+
+1. Go to **LunaNode.com**
+2. Sign up and add $10 credit
+3. Click "BTCPay Server" in marketplace
+4. Deploy one-click install ($3.50/month)
+5. Once deployed, note down:
+   - **Server URL:** `https://your-btcpay.lunanode.com`
+   - **Store ID:** (found in Settings → Stores)
+   - **API Key:** (create in Settings → Access Tokens)
+
+Save these - you'll need them!
+
+**Alternative (If LunaNode doesn't work):**
+- Use **OpenNode.com** - easier but takes 1% fee
+- Or **Strike.me** for US-based setup
+
+---
+
+## Step 4: Upload Your Code (30 minutes)
+
+### A. Create GitHub Account (if you don't have one)
+1. Go to **GitHub.com** 
+2. Sign up (free)
+3. Verify your email
+
+### B. Upload the Code
+1. Click the "+" in top right → "New repository"
+2. Name it: `agenthub-api`
+3. Make it **Private**
+4. Click "Create repository"
+5. Click "uploading an existing file"
+6. Drag and drop these files I created:
+   - `main.py`
+   - `requirements.txt`
+   
+7. Click "Commit changes"
+
+### C. Connect to Railway/Render
+1. Go back to Railway.app (or Render.com)
+2. Click "New Project" → "Deploy from GitHub"
+3. Select `agenthub-api` repository
+4. Railway will auto-detect it's Python
+5. Click "Deploy"
+
+---
+
+## Step 5: Configure Environment Variables (15 minutes)
+
+In Railway/Render dashboard:
+
+1. Click your project → "Variables" tab
+2. Add these variables:
+
+```
+BTCPAY_SERVER_URL=https://your-btcpay.lunanode.com
+BTCPAY_STORE_ID=your_store_id_from_step3
+BTCPAY_API_KEY=your_api_key_from_step3
+OPENWEATHER_API_KEY=get_free_from_openweathermap.org
+GOOGLE_MAPS_API_KEY=optional_for_now
+```
+
+3. Get free OpenWeather API key:
+   - Go to **openweathermap.org**
+   - Sign up free
+   - Get API key from dashboard
+   - Paste into Railway variables
+
+4. Click "Redeploy" (Railway will restart with new variables)
+
+---
+
+## Step 6: Connect Your Domain (20 minutes)
+
+### In Railway/Render:
+1. Click "Settings" → "Domains"
+2. Click "Add Domain"
+3. Enter your domain: `yourdomain.com`
+4. Copy the DNS records shown
+
+### In Namecheap:
+1. Go to your domain → "Advanced DNS"
+2. Add the DNS records from Railway
+3. Usually looks like:
+   - Type: `CNAME`
+   - Host: `@`
+   - Value: `your-app.railway.app`
+4. Save changes
+
+**Wait 5-60 minutes** for DNS to propagate (grab coffee ☕)
+
+---
+
+## Step 7: Test Your Services (30 minutes)
+
+Once your domain is live, test it:
+
+### Test 1: Check it's running
+Open browser, go to: `https://ugarapi.com/health`
+
+Should see: `{"status": "healthy"}`
+
+### Test 2: View AI manifest
+Go to: `https://ugarapi.com/.well-known/ai-services.json`
+
+Should see service list with prices
+
+### Test 3: Create a test payment
+Use this Python script (install Python first from python.org):
+
+```python
+import requests
+
+# Create payment
+response = requests.post(
+    "https://ugarapi.com/api/v1/payment/create",
+    json={
+        "service": "web_extraction",
+        "amount_sats": 1000
+    }
+)
+
+print(response.json())
+# You'll get a Lightning invoice to pay
+```
+
+### Test 4: Make actual request
+After paying the invoice above, use the `invoice_id` to test:
+
+```python
+import requests
+
+response = requests.post(
+    "https://ugarapi.com/api/v1/extract",
+    json={
+        "url": "https://example.com",
+        "selectors": {
+            "title": "h1",
+            "paragraphs": "p"
+        },
+        "payment_proof": "inv_abc123..."  # Your invoice_id
+    }
+)
+
+print(response.json())
+```
+
+---
+
+## Step 8: Marketing to AI Agents (Ongoing)
+
+### Immediate (Day 1):
+1. **Submit to AI directories:**
+   - AIPlugins.io
+   - ToolHub.ai
+   - LangChain integrations
+
+2. **Create public API docs:**
+   Your FastAPI already has docs at: `https://yourdomain.com/docs`
+
+3. **Post on X/Twitter:**
+   ```
+   🤖 Just launched AgentHub - automated services for AI agents
+   
+   ✅ Web data extraction
+   ✅ Document timestamping  
+   ✅ API aggregation
+   
+   Pay-per-use via Bitcoin Lightning ⚡
+   
+   https://yourdomain.com
+   ```
+
+### Week 1:
+4. **Register with MCP (Model Context Protocol):**
+   - Create MCP server config
+   - Submit to MCP directory
+   - AI systems can auto-discover you
+
+5. **Add to GitHub:**
+   - Create public repo with API examples
+   - Tag: `ai-agents`, `bitcoin`, `api`, `automation`
+
+### Month 1:
+6. **Partner outreach:**
+   - Email AI agent platforms (AutoGPT, AgentGPT)
+   - Offer free tier for their users
+   - Get featured in their marketplaces
+
+7. **Create demo video:**
+   - Screen recording of AI agent using your service
+   - Post on YouTube, LinkedIn
+
+---
+
+## Step 9: Monitor & Scale (Ongoing)
+
+### Set up monitoring:
+1. **UptimeRobot.com** (free)
+   - Monitor `https://ugarapi.com/health`
+   - Get alerts if down
+
+2. **Google Analytics**
+   - Track API usage
+   - See which services are popular
+
+### Scale when ready:
+- **10+ AI agents using you** → Upgrade hosting to $15/month tier
+- **100+ requests/day** → Add caching layer (Redis)
+- **$1000/month revenue** → Hire developer to add more services
+
+---
+
+## Troubleshooting
+
+### "502 Bad Gateway"
+- Check Railway logs: Dashboard → Logs
+- Usually means Python crashed
+- Check environment variables are set
+
+### "Payment required" error
+- Verify BTCPay Server is running
+- Check API key is correct
+- Test creating invoice manually in BTCPay
+
+### "Module not found" error
+- Railway should auto-install from requirements.txt
+- If not: click "Redeploy"
+
+### Domain not working
+- DNS can take up to 24 hours
+- Use `nslookup yourdomain.com` to check
+- Try accessing via Railway's temporary URL first
+
+---
+
+## Cost Breakdown (First 3 Months)
+
+| Month | Item | Cost |
+|-------|------|------|
+| Month 1 | Domain | $12 |
+| | Hosting | $0 (free credit) |
+| | BTCPay Server | $3.50 |
+| | API credits | $20 |
+| | **Total** | **$35.50** |
+| Month 2 | Hosting | $5 |
+| | BTCPay Server | $3.50 |
+| | API credits | $30 |
+| | **Total** | **$38.50** |
+| Month 3 | Hosting | $5 |
+| | BTCPay Server | $3.50 |
+| | API credits | $50 |
+| | Marketing | $50 |
+| | **Total** | **$108.50** |
+
+**Total 3-month cost:** ~$182.50 (well under your $500 budget!)
+
+---
+
+## What You'll Have After Setup
+
+✅ Live API at your own domain
+✅ 3 working services AI agents can discover
+✅ Bitcoin Lightning payment processing
+✅ Automatic invoicing and verification
+✅ Public API documentation
+✅ Usage tracking and analytics
+✅ 24/7 automated operation
+
+---
+
+## Support & Next Steps
+
+**Stuck? Here's how to get help:**
+1. Check Railway logs for errors
+2. Test each endpoint individually
+3. Verify all environment variables
+4. Ask me any questions!
+
+**Once live, focus on:**
+1. Getting first 10 AI agent customers
+2. Monitor which services are used most
+3. Improve based on usage data
+4. Add more services that complement popular ones
+
+**Remember:** The code handles everything automatically. Once deployed, it runs 24/7 without you touching it. Your job is just marketing and monitoring!
+
+---
+
+## Emergency Contacts
+
+- Railway Support: help@railway.app
+- BTCPay Support: https://chat.btcpayserver.org
+- Domain Issues: Namecheap live chat
+
+You've got this! 🚀

package/GITHUB_SETUP_GUIDE.md

@@ -0,0 +1,189 @@
+# GitHub Setup for UgarAPI - Super Simple Guide
+
+## What is GitHub?
+GitHub stores your code online so Railway can access it. Think of it like Google Drive, but for code.
+
+---
+
+## Step 1: Create GitHub Account (5 minutes)
+
+1. Go to: **github.com**
+2. Click "Sign up"
+3. Enter:
+   - Email: (your email)
+   - Password: (make it strong)
+   - Username: (anything you want, like "ugarapi" or your name)
+4. Verify email (check your inbox)
+5. **Done!** You now have a GitHub account
+
+---
+
+## Step 2: Create Your Repository (3 minutes)
+
+1. Once logged into GitHub, click the **"+"** icon (top right)
+2. Click **"New repository"**
+3. Fill in:
+   - **Repository name:** `ugarapi-service`
+   - **Description:** "AI services with Bitcoin Lightning payments"
+   - **Private or Public?** Choose **Private** (keeps your code hidden)
+4. Check the box: **"Add a README file"**
+5. Click **"Create repository"**
+
+You now have a place to store your code!
+
+---
+
+## Step 3: Upload Your Code Files (5 minutes)
+
+You should have these files downloaded:
+- `main.py`
+- `requirements.txt`
+- `DEPLOYMENT_GUIDE.md`
+- `ai_service_business_plan.md`
+- `MARKETING_STRATEGY.md`
+- `test_agent_simulator.py`
+
+**Upload them:**
+
+1. In your repository, click **"Add file"** → **"Upload files"**
+2. Drag all 6 files into the upload area
+3. At the bottom, type: "Initial upload - UgarAPI service"
+4. Click **"Commit changes"**
+
+**Done!** Your code is now on GitHub.
+
+---
+
+## Step 4: Connect Railway to GitHub (3 minutes)
+
+1. Go back to **railway.app**
+2. Click **"New Project"**
+3. Click **"Deploy from GitHub repo"**
+4. You'll see a popup asking to authorize Railway
+5. Click **"Authorize Railway"**
+6. Select **"Only select repositories"**
+7. Choose: `ugarapi-service`
+8. Click **"Install & Authorize"**
+
+**Railway can now see your code!**
+
+---
+
+## Step 5: Deploy to Railway (2 minutes)
+
+1. In Railway, click your repository: `ugarapi-service`
+2. Railway auto-detects it's Python ✅
+3. Click **"Deploy Now"**
+4. Wait 2-3 minutes while it builds...
+5. You'll see: **"Deployed successfully"** ✅
+
+---
+
+## Step 6: Get Your Temporary URL
+
+Before connecting your domain, Railway gives you a test URL:
+
+1. Click your service in Railway dashboard
+2. Click **"Settings"**
+3. Scroll to **"Domains"**
+4. You'll see something like: `ugarapi-service-production.up.railway.app`
+5. **Copy this URL** - we'll use it for testing
+
+**Test it:**
+Open browser, paste: `https://your-railway-url.railway.app/health`
+
+Should see: `{"status": "healthy"}`
+
+---
+
+## Step 7: Connect ugarapi.com to Railway
+
+### In Railway:
+1. Click **"Settings"** → **"Domains"**
+2. Click **"Custom Domain"**
+3. Enter: `ugarapi.com`
+4. Railway will show you DNS records to add
+
+**Copy these 2 pieces of info:**
+- **Type:** (usually CNAME)
+- **Value:** (something like `ugarapi-service.railway.app`)
+
+### In Namecheap:
+1. Log into Namecheap
+2. Find your domain: `ugarapi.com`
+3. Click **"Manage"**
+4. Go to **"Advanced DNS"** tab
+5. Click **"Add New Record"**
+6. Fill in:
+   - **Type:** CNAME
+   - **Host:** @ 
+   - **Value:** (paste from Railway)
+   - **TTL:** Automatic
+7. Click **"Save Changes"**
+
+**Wait 10-60 minutes** for DNS to update globally.
+
+---
+
+## Step 8: Verify It's Working
+
+After DNS updates:
+
+1. Open browser: `https://ugarapi.com/health`
+2. Should see: `{"status": "healthy"}`
+3. Check docs: `https://ugarapi.com/docs`
+4. Check AI manifest: `https://ugarapi.com/.well-known/ai-services.json`
+
+**All working?** You're LIVE! 🎉
+
+---
+
+## Common Issues
+
+### "Page not found"
+- DNS hasn't updated yet (wait longer)
+- Check Namecheap DNS settings match Railway exactly
+
+### "Application error"
+- Click Railway → Logs → see what error says
+- Usually missing environment variables (we'll add those next)
+
+### "This site can't be reached"
+- Railway might be building still (check deployment status)
+- DNS might not be updated (use nslookup to check)
+
+---
+
+## Next Steps After This
+
+Once your site is live at `ugarapi.com`:
+
+1. **Add environment variables** (BTCPay, API keys)
+2. **Set up BTCPay Server** for Bitcoin payments
+3. **Test with simulator** to make sure everything works
+4. **Start marketing** to AI agents
+
+I'll guide you through each step!
+
+---
+
+## Quick Reference
+
+**GitHub Repo:** github.com/YOUR_USERNAME/ugarapi-service
+**Railway Dashboard:** railway.app/project/YOUR_PROJECT
+**Live Site:** https://ugarapi.com
+**API Docs:** https://ugarapi.com/docs
+
+---
+
+## Need Help?
+
+**GitHub stuck?** 
+- Check: help.github.com
+- Or: Email support@github.com
+
+**Railway stuck?**
+- Check deployment logs in Railway dashboard
+- Or: Join Railway Discord (discord.gg/railway)
+
+**Let me know where you get stuck and I'll help troubleshoot!**