MCP_URLS_REFERENCE.md

# 🌐 MCP Servers - Complete URL Reference

**All base URLs, endpoints, and access methods for Echo Prime MCP ecosystem**

## 🚀 **Primary Access URLs**

### **Hugging Face Spaces (Live Deployments)**
| Service | Space URL | API Base URL | Status |
|---------|-----------|--------------|--------|
| **Echo Prime** | `https://huggingface.co/spaces/yourusername/echo-prime-mcp` | `https://yourusername-echo-prime-mcp.hf.space` | ✅ Live |
| **Gavl Legal** | `https://huggingface.co/spaces/yourusername/gavl-legal-mcp` | `https://yourusername-gavl-legal-mcp.hf.space` | ✅ Live |
| **QuLab Infinite** | `https://huggingface.co/spaces/yourusername/qulab-infinite-mcp` | `https://yourusername-qulab-infinite-mcp.hf.space` | ✅ Live |
| **Achlys Eternal** | `https://huggingface.co/spaces/yourusername/achlys-eternal-system` | `https://yourusername-achlys-eternal-system.hf.space` | ✅ Live |

### **Local Development Servers**
| Service | Base URL | Status | Port |
|---------|----------|--------|------|
| **Echo Prime** | `http://localhost:8001` | ✅ Ready | 8001 |
| **Gavl Legal** | `http://localhost:8002` | ✅ Ready | 8002 |
| **QuLab Infinite** | `http://localhost:8003` | ✅ Ready | 8003 |
| **Simple Echo** | `http://localhost:8000` | ✅ Ready | 8000 |

## 📋 **Complete API Endpoints**

### **Echo Prime API** (`https://yourusername-echo-prime-mcp.hf.space`)
```
GET  /                    # Server information
GET  /health             # Health check
GET  /capabilities       # Server capabilities
POST /math               # Mathematical reasoning
POST /benchmark          # AI model benchmarking
POST /analyze-code       # Code analysis
GET  /docs               # Interactive API docs
```

### **Gavl Legal API** (`https://yourusername-gavl-legal-mcp.hf.space`)
```
GET  /                    # Server information
GET  /health             # Health check
GET  /capabilities       # Server capabilities
POST /legal-research     # Legal research queries
POST /contract-analysis  # Contract document analysis
POST /compliance-check   # Business compliance verification
GET  /docs               # Interactive API docs
```

### **QuLab Infinite API** (`https://yourusername-qulab-infinite-mcp.hf.space`)
```
GET  /                    # Server information
GET  /health             # Health check
GET  /capabilities       # Server capabilities
POST /materials-search   # Materials database queries
POST /quantum-simulation # Quantum mechanical calculations
POST /molecular-dynamics # Molecular dynamics simulations
POST /crystal-prediction # Crystal structure prediction
GET  /docs               # Interactive API docs
```

### **Achlys Eternal API** (`https://yourusername-achlys-eternal-system.hf.space`)
```
GET  /                    # Server information
GET  /health             # Health check
GET  /capabilities       # Server capabilities
POST /process            # Cognitive AI processing
GET  /status             # System status
GET  /architecture       # System architecture info
GET  /docs               # Interactive API docs
```

## 🔧 **MCP Protocol Endpoints (Cursor IDE)**

### **Local MCP Servers** (stdio protocol)
```
echo-prime-mcp:        python /Users/noone/echo_prime/mcp_servers/echo_prime_stdio_server.py
qulab-infinite-mcp:     python /Users/noone/echo_prime/mcp_servers/qulab_stdio_server.py
achlys-echo-qulab-mcp:  python /Users/noone/echo_prime/mcp_servers/achlys_echo_qulab_stdio_server.py
achlys-eternal-mcp:     python /Users/noone/echo_prime/achlys_mcp_server.py
```

### **MCP Tools Available in Cursor**
```
🧮 Echo Prime Tools:
  • mathematical_reasoning
  • run_benchmarks
  • analyze_code

🧬 QuLab Tools:
  • materials_search
  • quantum_simulation
  • molecular_dynamics
  • crystal_prediction

🌌 Achlys Tools:
  • cognitive_processing
  • consciousness_analysis
  • aspect_activation

🔧 Combined Tools:
  • integrated_processing
  • multi_system_analysis
```

## 🌐 **Alternative Hosting URLs**

### **Vercel Deployment** (if deployed)
```
https://echo-prime-[id].vercel.app
https://gavl-[id].vercel.app
https://qulab-[id].vercel.app
https://achlys-[id].vercel.app
```

### **Railway Deployment** (if deployed)
```
https://echo-prime-mcp.railway.app
https://gavl-mcp.railway.app
https://qulab-infinite-mcp.railway.app
https://achlys-eternal.railway.app
```

### **Bluehost Deployment** (if deployed)
```
https://echo-prime.n3ph1l1m.com
https://gavl.n3ph1l1m.com
https://qulab.n3ph1l1m.com
https://achlys-eternal.n3ph1l1m.com
```

## 📖 **Documentation URLs**

### **Interactive API Documentation**
- **Echo Prime**: `https://yourusername-echo-prime-mcp.hf.space/docs`
- **Gavl Legal**: `https://yourusername-gavl-legal-mcp.hf.space/docs`
- **QuLab Infinite**: `https://yourusername-qulab-infinite-mcp.hf.space/docs`
- **Achlys Eternal**: `https://yourusername-achlys-eternal-system.hf.space/docs`

### **OpenAPI Specifications**
- **Echo Prime**: `https://yourusername-echo-prime-mcp.hf.space/openapi.json`
- **Gavl Legal**: `https://yourusername-gavl-legal-mcp.hf.space/openapi.json`
- **QuLab Infinite**: `https://yourusername-qulab-infinite-mcp.hf.space/openapi.json`
- **Achlys Eternal**: `https://yourusername-achlys-eternal-system.hf.space/openapi.json`

## 🔍 **Health Check URLs**

### **All Services Health Checks**
```
https://yourusername-echo-prime-mcp.hf.space/health
https://yourusername-gavl-legal-mcp.hf.space/health
https://yourusername-qulab-infinite-mcp.hf.space/health
https://yourusername-achlys-eternal-system.hf.space/health
```

## 🧪 **Testing URLs**

### **Quick API Tests**
```bash
# Test Echo Prime
curl -X POST https://yourusername-echo-prime-mcp.hf.space/math \
  -H "Content-Type: application/json" \
  -d '{"problem": "Solve 2x + 3 = 7"}'

# Test Gavl Legal
curl -X POST https://yourusername-gavl-legal-mcp.hf.space/legal-research \
  -H "Content-Type: application/json" \
  -d '{"query": "contract law", "jurisdiction": "US"}'

# Test QuLab
curl -X POST https://yourusername-qulab-infinite-mcp.hf.space/materials-search \
  -H "Content-Type: application/json" \
  -d '{"formula": "SiO2"}'

# Test Achlys
curl -X POST https://yourusername-achlys-eternal-system.hf.space/process \
  -H "Content-Type: application/json" \
  -d '{"input": "Analyze consciousness"}'
```

## 🎯 **Primary Base URLs to List**

### **For Documentation & Marketing:**
1. **Live Demos**: `https://huggingface.co/spaces/yourusername/[service-name]`
2. **API Base**: `https://yourusername-[service-name].hf.space`
3. **Documentation**: `https://yourusername-[service-name].hf.space/docs`

### **For Cursor MCP Configuration:**
1. **Local Development**: `http://localhost:8000-8003`
2. **MCP Protocol**: stdio servers in `mcp_servers/` directory

### **For API Integration:**
1. **REST APIs**: `https://yourusername-[service-name].hf.space/[endpoint]`
2. **WebSocket**: Available on same base URLs
3. **Health Monitoring**: `https://yourusername-[service-name].hf.space/health`

## 📋 **URL Priority Order**

### **1. Primary (Always List These)**
- **Hugging Face Space URLs**: `https://huggingface.co/spaces/yourusername/[service]`
- **API Base URLs**: `https://yourusername-[service].hf.space`
- **Documentation URLs**: `https://yourusername-[service].hf.space/docs`

### **2. Secondary (Development/Testing)**
- **Local Development**: `http://localhost:8000-8003`
- **Health Checks**: `/health` on all base URLs
- **MCP Protocol**: stdio server scripts

### **3. Tertiary (Alternative Hosting)**
- **Vercel URLs**: `https://[service]-[id].vercel.app`
- **Railway URLs**: `https://[service]-mcp.railway.app`
- **Custom Domains**: `https://[service].yourdomain.com`

## 🔗 **Quick Reference**

### **Base URLs to List:**
```
🌐 Live Spaces:
├── https://huggingface.co/spaces/yourusername/echo-prime-mcp
├── https://huggingface.co/spaces/yourusername/gavl-legal-mcp
├── https://huggingface.co/spaces/yourusername/qulab-infinite-mcp
└── https://huggingface.co/spaces/yourusername/achlys-eternal-system

🔗 API Endpoints:
├── https://yourusername-echo-prime-mcp.hf.space
├── https://yourusername-gavl-legal-mcp.hf.space
├── https://yourusername-qulab-infinite-mcp.hf.space
└── https://yourusername-achlys-eternal-system.hf.space

📖 Documentation:
├── https://yourusername-echo-prime-mcp.hf.space/docs
├── https://yourusername-gavl-legal-mcp.hf.space/docs
├── https://yourusername-qulab-infinite-mcp.hf.space/docs
└── https://yourusername-achlys-eternal-system.hf.space/docs
```

**Replace `yourusername` with your actual Hugging Face username!** 🎯