Crypto Multi-MCP Hub
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
๐ Crypto MCP Server & Hedgehog Agentic Trading Dashboard ๐ฆ
A Professional-Grade, Fully Localized AI Hedge Fund Orchestrator.
A massively scaled Model Context Protocol (MCP) infrastructure designed to act as a localized, AI-powered Hedge Fund Orchestrator. It acts as the backbone for local LLMs (like Claude Desktop) to ingest real-time market data, analyze technicals/sentiment, and autonomously execute trades.
๐ Author: Pelle Nyberg | Corax CoLAB ๐ช Explore more: Crypto P's Crypto Circus
๐งฌ What makes this different?
This is not just another API wrapper. It is a multi-agent architectural playground.
Zero Mock-ups. 100% Real Data. Every visualizer, sonar sweep, and grid is driven by live websockets and REST data.
Extensible MCP Architecture. Easily add new modules. The system natively multiplexes JSON-RPC commands.
Hardened Security. Local SQLite, password-protected backend execution, no cross-site scripting gaps. Uses
crypto.timingSafeEqualfor password verification.
Our terminal is a living, breathing Hedge Fund AI Orchestrator, packed with cutting-edge tools.
๐ค Autonomous Orchestrator Mode (Agentic Loop)
Evolving from a passive Multi-MCP tool, the server acts as an autonomous 24/7 trading agent framework running a continuous Observe-Analyze-Act (OODA) loop.
๐๏ธ Observe (
gather_market_data): Queries multiple MCPs (e.g., Technical indicators, News sentiment, On-chain data).๐ง Analyze (
analyze_with_llm): Evaluates signals using an LLM (Gemini, Claude, or OpenAI) for a structured decision (BUY, SELL, HOLD).โก Act (
execute_trade): Executes trades via the local CCXT MCP.๐งช Agentic Backtesting: Safely test AI prompts and models against historical OHLCV data without risking real funds.
๐ Proof of Brain (Trading Diary): Comprehensive markdown reports detailing the "Board of Directors" reasoning for every action taken.
๐ฑ Telegram Command Center
Receive real-time alerts and command your trading agent via Telegram.
/status: View active AI providers and last decisions./report: Receive your latest "Proof of Brain" report./analyze: Trigger a manual OODA cycle.
๐ 100% Real Data Integration & Visualizer Dynamics
The Crypto MCP Server uses real data across all visualizers. The entire system operates without a single mockup!
๐ฏ Dark Pool Sonar: Real-time 3D sonar pings for large volume "whale" trades on central exchanges using
@react-three/fiberand dynamic emissive materials.๐ฅ Flash-Crash Prediction Matrix: Glowing heatmap grid of bids to asks, tracking liquidity drains in real time via CCXT orderbooks.
๐ Galaxy View (Gravity Well): Cinematic 3D mapping of the top 50 cryptocurrencies with a glowing central sun and accretion disk.
๐ง AI Sentiment Word-Cloud Sphere: Extracts trending keywords and sentiment from real-time news to form an interactive 3D floating sphere.
โก Gas & Network Congestion Hologram: Visualizes Ethereum network congestion as a glowing, pulsating reactor core.
๐ฌ Time-Machine Backtest Arena: Fully functional OHLCV visualizer to playback and simulate trading strategies (e.g. SMA Crossovers).
๐ง Oracle Copilot: Voice-activated command center powered by local LLMs via
MCP_LLM.๐ Global Weather System: Dynamic 3D visualization of market volatility and network states using
@react-three/fiber.๐ Whale Sonar Sweep & Constellations: 3D plotting of significant market movers using CoinGecko and CCXT data.
๐ Arbitrage Wormhole: Scans and visualizes cross-exchange price discrepancies via
MCP_CCXT.๐ Risk Radar Panel & Quantum Risk Map: Spatial representation of portfolio risk, exposure, and technical analysis indicators (RSI, MACD) via
MCP_TA.๐ก Market Sentiment Analyzer: Synthesizes news, price action, and LLM analysis for a comprehensive market mood score.
๐ฎ Predictive Ghosting: Overlays projected price actions based on historical patterns using
plotlyandMCP_TA.๐ Neural Net Liquidity & Trade Visualizer: 3D force-directed graphs showing the flow of liquidity and order execution.
๐๏ธ Algo Grid Architect: Node-based strategy builder and visualizer for algorithmic trading logic.
๐ Holo Order Flow & Topographic Order Book: Three-dimensional mapping of order book depth and flow.
๐ช Asset Universe & Orbital Portfolio: Represents portfolio holdings as a 3D solar system with relative distances and sizes.
๐ฐ News Singularity: Aggregates and visually groups crypto news streams using
MCP_NEWS.โก Volatility Matrix: Visualizes standard deviations and market swings in a grid.
๐ฅ๏ธ System Overview: A comprehensive hub showing MCP node statuses and system health.
Related MCP server: bybit-trading-mcp
๐ The Multi-MCP Ecosystem
This repository comes bundled with over a dozen powerful MCPs (Model Context Protocol). They provide execution, raw data, analysis, and external system integrations.
MCP Server | Description | Port |
๐ฑ | The core exchange trading & market data integration via CCXT. |
|
โ๏ธ | ETH balances, ERC20 balances, transaction info, and live Gas Prices. |
|
๐ | Compute Technical Indicators (RSI, MACD, SMA50, BB) and Monte Carlo Simulations. |
|
๐ผ | Aggregated portfolio balances and performance tracking. |
|
๐ฆ | Deep market stats, top coins, and historical trends. |
|
๐ง | Local/Remote LLM operations and Copilot interactions. |
|
๐ | System notifications, alerts, and Telegram broadcasting. |
|
๐ | Interfaces with local Freqtrade instances via REST APIs. |
|
๐๏ธ | Prediction markets for agents via HeadlineArena (financial and Civic Index). |
|
๐ | Interfaces with local OctoBot instances via REST APIs. |
|
๐ฆ | Controls local Hummingbot Gateway APIs. |
|
๐ค | Interacts with the Superalgos platform API. |
|
๐ฐ | Fetches the latest crypto news from CryptoPanic. |
|
๐บ๏ธ System Overview & Architecture
Explore the architecture, installation success, and security models below:
๐ธ [INSERT LATEST GUI SCREENSHOT HERE] (Please upload the latest working system screenshot or animation here)
โ Quick Start โ Automated
Place the provided install.sh into $HOME/install.sh (or $HOME/cryptomcpserver/install.sh if you prefer). Make it executable and run it:
# Save install.sh to $HOME/install.sh, then:
cd $HOME
chmod +x install.sh
./install.shWhat install.sh does (summary):
Creates directories and writes backend & frontend files.
Installs Node.js if missing and runs
npm installfor backend & frontend.Ensures the
orderstable exists in$HOME/cryptomcpserver/gui/backend/orders.db.Frees port
4000if occupied, then installs & enables the systemd servicecrypto-mcp-gui.service.Attempts a production build of the frontend.
After running, check service status and logs:
sudo systemctl status crypto-mcp-gui.service
sudo journalctl -u crypto-mcp-gui.service -f๐ Manual Install
If you prefer a hands-on approach:
1. Install system deps & Python Requirements:
sudo apt update
sudo apt install -y curl build-essential ca-certificates git python3-pip
pip3 install -r requirements.txt2. Install Node.js (if needed):
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs3. Backend & Global Config:
cd $HOME/cryptomcpserver
cp .env.example .env
# Edit .env to add your passwords, keys, and allowed pairs
cd gui/backend
npm install4. Frontend (Dev):
cd $HOME/cryptomcpserver/gui/frontend
npm install
npm run dev -- --host # Open http://<PI_IP>:5173 on your laptop5. Systemd (Backend):
# Create /etc/systemd/system/crypto-mcp-gui.service
sudo systemctl daemon-reload
sudo systemctl enable --now crypto-mcp-gui.serviceโ๏ธ Configuration
The system uses a centralized .env file located at the root of the project to manage both Python MCP servers and the Node.js backend.
Copy and edit $HOME/cryptomcpserver/.env.example โ .env:
# Essential configuration
PORT=4000
DASHBOARD_PASSWORD=your_secure_password # Required for trading and AI reasoning
ALLOWED_PAIRS=BTC/USDT,SOL/USDT # Fail-closed security: only these pairs are allowed
MAX_TRADE_USD=100.0 # Maximum allowed trade amount per transaction
# API Keys
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret
# --- Autonomous Orchestrator Settings ---
ACTIVE_LLM_PROVIDER="gemini"
GEMINI_API_KEY="your_google_gemini_key_here"
TELEGRAM_BOT_TOKEN="your_token_here"
TELEGRAM_CHAT_ID="your_chat_id_here"๐ Claude Desktop Integration
Add MCP servers in Claude Desktop (Step-by-step)
Open the Claude Desktop app.
Navigate to App Settings / Preferences.
Find Local MCP Servers.
Click
+(Add) and fill in the fields:Name:
ccxtDescription:
CCXT MCP โ exchange trading & market dataTransport:
httpEndpoint:
http://127.0.0.1:7001/mcp(if Claude runs on Pi) orhttp://<pi-ip>:7001/mcp(if Claude runs on laptop)
Save. Repeat for other MCPs (
coingecko,portfolio,onchain,ta,news, etc.) using their respective ports.
๐ฅ Dashboard User Manual
๐ Portfolio: View aggregated balances & USD value.
๐ Ticker: Live market data (via
ccxtMCP).๐ Order / Trade:
Preview (
dry_run): Calculates estimated cost and logs a preview.Confirm โ Place order: Sends
create_orderto CCXT MCP.
๐ Orders Log: Real-time updates via Socket.io, paginated with indices.
๐ค AI Copilot: Voice-activated command center powered by local LLMs.
โ ๏ธ Safety Warning: Always test with testnet keys. The UI requires confirmation to execute live orders.
๐ Security & Best Practices
๐งช Testnet First: Use testnet keys while testing your strategies.
๐ Environment Variables: Keep API keys absolutely out of the repository.
๐ก๏ธ Network Isolation: Restrict access to MCP endpoints to your local LAN only.
๐ Authentication: Endpoints are fully secured with
DASHBOARD_PASSWORDverification and robust anti-SSRF checks.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Crypto market & research MCP for AI agents: prices, derivatives, options, on-chain, sentiment, news.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
AI agent access to Asian crypto markets. Korean exchange routing and x402 paid APIs.
No-KYC managed MCP for AI agents: sandboxed TypeScript trading SDK, isolated sub-accounts, futures.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI clients to access live crypto market data and AI-driven quantitative analysis, with structured outputs and full observability.-
- FlicenseNot gradedqualityDmaintenanceEnables AI tools to execute trades and fetch market data across six crypto exchanges via natural language or API, with dual Telegram and MCP interfaces.2-
- FlicenseNot gradedqualityDmaintenanceSecure broker gateway and stateful trading SaaS that bridges LLM AI agents with brokerage accounts via MCP, encrypting credentials and supporting connectors for Bybit, MetaTrader 5, TradingView, and more.-
- AlicenseNot gradedqualityBmaintenanceSecurity-first Binance MCP server and multi-agent intelligence platform. Read market data, quant analytics, and propose spot trades behind human confirmation.4MIT