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

# 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! 🎯