🔌 MCP Servers Collection

A collection of 9 production-ready MCP (Model Context Protocol) servers providing AI assistants with access to cryptocurrency data, web search, document retrieval, prediction markets, and more.

---

📋 Overview

This repository contains 9 MCP servers that extend AI capabilities with real-time data and specialized tools:

Server	Description	Tools	API
CoinGecko	Cryptocurrency prices & market data	18	Free
Fear & Greed	Crypto market sentiment index	3	Free
Perplexity	AI-powered web search	7	Key required
Vector RAG	Document storage & semantic search	17	Key required
CoinMarketCap	Professional crypto market data	12	Key required
X Search	Social media search via Grok	4	Key required
Polymarket	Prediction markets data	4	Free
HyperLiquid	DeFi perpetuals trading	44	Free
Heavy MCP	Multi-agent AI orchestration	2	Key required

Total: 111 tools available across all servers

---

🚀 Quick Start

Prerequisites

• Docker & Docker Compose
• Caddy (for HTTPS reverse proxy)
• Node.js 18+ (for local development)

1. Clone the Repository

git clone https://github.com/Sokalledcoder/LATEST-MCPS.git
cd LATEST-MCPS

2. Configure Environment

Each server has a .env.example file. Copy and configure:

# Example for CoinGecko (no API key needed)
cd coingecko-mcp
cp .env.example .env

# Example for Perplexity (API key required)
cd perplexity-mcp
cp .env.example .env
# Edit .env and add your PERPLEXITY_API_KEY

3. Start Servers

# Start individual server
cd coingecko-mcp
docker build -t coingecko-mcp .
docker run -d --name coingecko-mcp -p 3900:3900 --env-file .env coingecko-mcp

# Or use docker-compose where available
cd polymarket-mcp
docker-compose up -d

4. Configure Caddy

Copy the Caddyfile to your Caddy configuration:

sudo cp Caddyfile.new /etc/caddy/Caddyfile
sudo systemctl reload caddy

5. Verify

# Test health endpoint
curl https://coingecko-mcp.YOUR-IP.nip.io/health

# Test MCP protocol
curl -X POST https://coingecko-mcp.YOUR-IP.nip.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

---

📁 Project Structure

LATEST-MCPS/
├── README.md                    # This file
├── docs/
│   ├── SERVERS-DETAILED.md      # Detailed server documentation
│   └── ...
├── coingecko-mcp/               # CoinGecko MCP Server
├── fearandgreed-mcp/            # Fear & Greed MCP Server
├── perplexity-mcp/              # Perplexity MCP Server
├── vector-rag-typescript/       # Vector RAG MCP Server
├── coinmarketcap-mcp/           # CoinMarketCap MCP Server
├── x-search-mcp/                # X Search (Grok) MCP Server
├── polymarket-mcp/              # Polymarket MCP Server
├── hyperliquid-mcp/             # HyperLiquid MCP Server
├── heavy-mcp/                   # Heavy MCP Server
├── MCP-RESTART-GUIDE.md         # Operations guide for restarting servers
├── Caddyfile.new                # Caddy reverse proxy configuration
└── test-all-servers.sh          # Test script for all servers

---

🔧 Operations

Restart All Servers

See MCP-RESTART-GUIDE.md for complete instructions.

Quick restart:

docker restart \
  coingecko-complete-fixed-final \
  fearandgreed-production-fixed \
  perplexity-production \
  vector-rag-final-working \
  coinmarketcap-production \
  xai-search-mcp \
  polymarket-mcp-server \
  hyperliquid-production \
  heavy-mcp-production

Verify All Servers

for server in coingecko-mcp fearandgreed-mcp perplexity-mcp vector-rag-mcp coinmarketcap-mcp xai-search-mcp polymarket-mcp hyperliquid-mcp heavy-mcp; do
  echo -n "$server: "
  curl -s -m 5 "https://${server}.46.62.210.171.nip.io/health" | grep -q "healthy" && echo "✓" || echo "✗"
done

---

🔌 Connecting to MCP Clients

Windsurf / Cursor IDE

Add to your mcp_config.json:

{
  "mcpServers": {
    "coingecko": {
      "url": "https://coingecko-mcp.46.62.210.171.nip.io/mcp",
      "disabled": false
    },
    "perplexity": {
      "url": "https://perplexity-mcp.46.62.210.171.nip.io/mcp",
      "disabled": false
    }
  }
}

OpenAI Playground

Use the HTTPS endpoints directly in the MCP integration settings.

---

📊 Server Ports

Server	Port	Container Name
CoinGecko	3900	coingecko-complete-fixed-final
Fear & Greed	4000	fearandgreed-production-fixed
Perplexity	4200	perplexity-production
Vector RAG	4300	vector-rag-final-working
CoinMarketCap	4400	coinmarketcap-production
X Search	4500	xai-search-mcp
Polymarket	4550	polymarket-mcp-server
HyperLiquid	4600	hyperliquid-production
Heavy MCP	4700	heavy-mcp-production

---

🔐 API Keys

Some servers require API keys:

Server	Environment Variable	Get Key From
Perplexity	PERPLEXITY_API_KEY	perplexity.ai
Vector RAG	OPENAI_API_KEY	openai.com
CoinMarketCap	COINMARKETCAP_API_KEY	coinmarketcap.com
X Search	XAI_API_KEY	x.ai
Heavy MCP	OPENROUTER_API_KEY	openrouter.ai

---

🌐 VPN Considerations

If running behind a VPN (e.g., Mullvad):

• Perplexity MCP needs host networking:

  docker run -d --name perplexity-production \
    --network host \
    -e NODE_OPTIONS="--dns-result-order=ipv4first" \
    --env-file .env perplexity-mcp:multi-timeframe

See MCP-RESTART-GUIDE.md for details.

---

📚 Documentation

• Detailed Server Documentation - Complete guide to all servers
• Restart Guide - Operations guide for restarting and verifying
• MCP Specification - Official MCP documentation

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Anthropic - MCP Specification
• CoinGecko - Cryptocurrency data API
• Perplexity AI - AI search capabilities
• OpenAI - Embeddings and vector storage
• HyperLiquid - DeFi perpetuals
• Polymarket - Prediction markets

---

Last Updated: December 11, 2025