{"id":48518074,"url":"https://github.com/pellenybe/crypto-mcp-server---by-corax-colab","last_synced_at":"2026-04-07T20:01:54.306Z","repository":{"id":308930416,"uuid":"1034615820","full_name":"PelleNybe/Crypto-MCP-Server---by-Corax-CoLAB","owner":"PelleNybe","description":"Crypto MCP Server by Corax CoLAB. Enables Claude to: Fetch prices (CoinGecko), Trade (CCXT), Get on-chain data, Perform TA, Aggregate portfolios, Send alerts, and Sync with Freqtrade via a cyberpunk 3D dashboard.","archived":false,"fork":false,"pushed_at":"2026-04-03T01:47:10.000Z","size":1320,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T11:26:42.642Z","etag":null,"topics":["ccxt","claude","coingecko","cryptocurrency","freqtrade","mcp","rest-api"],"latest_commit_sha":null,"homepage":"https://coraxcolab.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PelleNybe.png","metadata":{"files":{"readme":"README.md","changelog":"news_mcp.py","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-08T17:23:17.000Z","updated_at":"2026-04-03T01:47:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"2f4bd4b2-c8ab-4b11-b315-9182ec18eaf8","html_url":"https://github.com/PelleNybe/Crypto-MCP-Server---by-Corax-CoLAB","commit_stats":null,"previous_names":["coraxgs/crypto-mcp-server---by-corax-colab","pellenybe/crypto-mcp-server---by-corax-colab"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PelleNybe/Crypto-MCP-Server---by-Corax-CoLAB","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PelleNybe%2FCrypto-MCP-Server---by-Corax-CoLAB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PelleNybe%2FCrypto-MCP-Server---by-Corax-CoLAB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PelleNybe%2FCrypto-MCP-Server---by-Corax-CoLAB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PelleNybe%2FCrypto-MCP-Server---by-Corax-CoLAB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PelleNybe","download_url":"https://codeload.github.com/PelleNybe/Crypto-MCP-Server---by-Corax-CoLAB/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PelleNybe%2FCrypto-MCP-Server---by-Corax-CoLAB/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31526666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ccxt","claude","coingecko","cryptocurrency","freqtrade","mcp","rest-api"],"created_at":"2026-04-07T20:01:52.032Z","updated_at":"2026-04-07T20:01:54.290Z","avatar_url":"https://github.com/PelleNybe.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://cryptop.coraxcolab.com\" target=\"_blank\"\u003e\n    \u003cimg width=\"800\" alt=\"Frontend Dashboard\" src=\"./gui/frontend/public/images/dashboard.png\" style=\"border-radius: 12px; margin-bottom: 20px; box-shadow: 0 0 20px rgba(16, 185, 129, 0.4);\" /\u003e\n  \u003c/a\u003e\n\n  \u003ch1\u003e🌌 Crypto Multi-MCP Hub \u003cbr\u003e \u003cspan style=\"font-size: 0.6em; color: #10b981;\"\u003eby Corax CoLAB \u0026 PelleNybe 🚀🪙\u003c/span\u003e\u003c/h1\u003e\n  \u003ch2\u003eHedge Fund AI Orchestrator\u003c/h2\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/PelleNybe\"\u003e\u003cimg src=\"https://readme-typing-svg.herokuapp.com?font=Fira+Code\u0026weight=600\u0026size=22\u0026pause=1000\u0026color=10B981\u0026center=true\u0026vCenter=true\u0026width=800\u0026lines=Welcome+to+Crypto+MCP+Server;The+Future+of+Edge+AI+%26+Blockchain;AI-driven+command+center;100%25+Real+Data+Integration;Built+with+React,+Three.js+%26+Python\" alt=\"Typing SVG\" /\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/PelleNybe\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-3.0.0-blue.svg?style=for-the-badge\u0026logo=github\" alt=\"Version\"/\u003e\u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/badge/python-\u003e=3.10-blue.svg?style=for-the-badge\u0026logo=python\" alt=\"Python\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/node-\u003e=20.x-green.svg?style=for-the-badge\u0026logo=nodedotjs\" alt=\"Node.js\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/React-Vite-61dafb.svg?style=for-the-badge\u0026logo=react\" alt=\"React\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Three.js-3D-black.svg?style=for-the-badge\u0026logo=three.js\" alt=\"Three.js\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge\" alt=\"License\"/\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003e\u003cem\u003eThe ultimate AI-driven command center and Multi-MCP Hub for your local crypto operations, featuring a dark, cyberpunk/command-center aesthetic. Built for everyone, from homebrew Raspberry Pi setups to cloud servers.\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 👨‍💻 Developer \u0026 Company\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg\" width=\"100%\" height=\"2\" onerror=\"this.style.display='none'\"/\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  This project is brought to you by \u003cstrong\u003ePelle Nyberg\u003c/strong\u003e and his company, \u003cstrong\u003eCorax CoLAB\u003c/strong\u003e.\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ch3\u003e\u003ca href=\"https://pellenybe.github.io\" target=\"_blank\"\u003ePelle Nyberg\u003c/a\u003e\u003c/h3\u003e\n        \u003cp\u003eLead Developer \u0026 Architect\u003c/p\u003e\n        \u003ca href=\"https://github.com/PelleNybe\"\u003e\u003cimg src=\"https://img.shields.io/badge/GitHub-100000?style=for-the-badge\u0026logo=github\u0026logoColor=white\" alt=\"GitHub\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://www.linkedin.com/in/pellenyberg/\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" alt=\"LinkedIn\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://pellenybe.github.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/Portfolio-FF5722?style=for-the-badge\u0026logo=Web\u0026logoColor=white\" alt=\"Portfolio\"/\u003e\u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ch3\u003e\u003ca href=\"https://coraxcolab.com\" target=\"_blank\"\u003eCorax CoLAB\u003c/a\u003e\u003c/h3\u003e\n        \u003cp\u003eInnovation \u0026 AI Solutions\u003c/p\u003e\n        \u003ca href=\"https://coraxcolab.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Website-000000?style=for-the-badge\u0026logo=Google-Chrome\u0026logoColor=white\" alt=\"Website\"/\u003e\u003c/a\u003e\n        \u003ca href=\"https://cryptop.coraxcolab.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/Crypto_Dashboard-10b981?style=for-the-badge\u0026logo=Bitcoin\u0026logoColor=white\" alt=\"Crypto Dashboard\"/\u003e\u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg\" width=\"100%\" height=\"2\" onerror=\"this.style.display='none'\"/\u003e\n\u003c/div\u003e\n\n---\n\n## 📚 Table of contents\n\n\u003cdetails open\u003e\n  \u003csummary\u003e\u003cb\u003eClick to expand/collapse contents\u003c/b\u003e\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"#-developer--company\"\u003e👨‍💻 Developer \u0026 Company\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-100-real-data-integration--visualizer-dynamics-upgraded-v30\"\u003e🌌 100% Real Data Integration \u0026 Visualizer Dynamics\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#️-system-overview--architecture\"\u003e🗺️ System Overview \u0026 Architecture\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-quick-start--automated\"\u003e✅ Quick start — automated\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-manual-install\"\u003e🛠 Manual install\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#️-configuration\"\u003e⚙️ Configuration\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-claude-desktop-integration\"\u003e🔗 Claude Desktop integration\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-dashboard-user-manual\"\u003e🖥 Dashboard user manual\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#-security--best-practices\"\u003e🔒 Security \u0026 best practices\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n---\n\n## 🌌 100% Real Data Integration \u0026 Visualizer Dynamics (Upgraded v3.0)\n\nThe Crypto MCP Server has been heavily upgraded to ensure **every single conceptual placeholder has been actively replaced with real data mechanisms**. The entire system operates without a single mockup across visualizers. All 3D graphs reflect live local data.\n\n*   🎯 **Dark Pool Sonar:** Real-time 3D sonar pings for large volume \"whale\" trades on central exchanges. Connected to `MCP_CCXT` to monitor `fetch_trades` data and renders physics-based 3D ripples with `@react-three/fiber`.\n*   🔥 **Flash-Crash Prediction Matrix:** Visualizes the ratio of bids to asks as a dynamic glowing heatmap grid, tracking potential liquidity drains using `MCP_CCXT` `fetch_order_book`.\n*   🚀 **Galaxy View (Gravity Well):** Maps the top 50 cryptocurrencies in a 3D galaxy using `MCP_COINGECKO`. Star size = Market Cap, orbit speed = Volume, color = 24h change.\n*   🧠 **AI Sentiment Word-Cloud Sphere:** Fetches recent crypto news via `MCP_NEWS` and extracts trending keywords and sentiment to form a 3D interactive floating word sphere.\n*   ⚡ **Gas \u0026 Network Congestion Hologram:** Visualizes current Ethereum network congestion as a glowing, pulsating reactor core using `MCP_ONCHAIN` `gas_price`. Faster pulsing/red colors indicate high congestion.\n\n### 🏛 Legacy Visualizers\n*   **Arbitrage Wormhole:** Live Cross-DEX arbitrage detection using multi-exchange CCXT MCP polling.\n*   **Neural Trade Visualizer:** Calculates genuine diagnostic routing data retrieved from live orderbooks (L2 Bids/Asks) using `react-three-fiber`.\n*   **Quantum Risk Map:** Real-time 3D topography of your portfolio risk exposure.\n*   **Orbital Portfolio Deck:** A dynamic, physics-based 3D visualization of your actual asset allocation.\n*   **Global Weather System:** An interactive background system that reacts to the current market sentiment (Bull, Bear, Neutral), altering the entire visual environment.\n\n---\n\n\n## 🚀 The Multi-MCP Ecosystem\n\nThis repository has evolved into a **Multi-MCP Hub** - a Hedge Fund AI Orchestrator. The vision is that anyone downloading this repo can easily configure their AI agent to use our server for execution/raw data, combined with external public MCPs for analysis.\n\nSynergy examples:\n*   **Aarna ATARS:** High-frequency sentiment signals and specialized DeFi analytics.\n*   **Blockscout:** Contract safety, verified smart contract readouts.\n*   **LunarCrush:** Social sentiment and trending metrics.\n*   **Corax Crypto MCP (This repo):** Trade execution, real-time monitoring, and local AI reasoning.\n\n### How to use the Multi-MCP Configuration\n\nWe provide a `multi_mcp_config.example.json` file that shows you how to connect your AI client (like Claude Desktop or Cursor) to multiple servers simultaneously.\n\n1.  Open your AI client's MCP configuration file.\n    *   **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows).\n    *   **Cursor:** Add servers in Cursor Settings \u003e Features \u003e MCP.\n2.  Copy the structure from `multi_mcp_config.example.json`.\n3.  Fill in any required API keys (like `LUNARCRUSH_API_KEY`).\n4.  Restart your AI client.\n\nThis setup is completely hardware- and OS-agnostic. Use `start_server.sh` or Docker to run the local Corax Server seamlessly on any environment!\n\n\n## 🤖 Autonomous Orchestrator Mode (Agentic Loop)\n\nWe are introducing **Track 2: Agentic Orchestration**, evolving the project from a passive Multi-MCP tool into an autonomous, 24/7 trading agent framework.\n\nThe `autonomous_orchestrator.py` script acts as an MCP Client, automatically connecting to the MCPs defined in your `multi_mcp_config.example.json`.\n\nIt runs a continuous **Observe-Analyze-Act** (OODA) loop:\n1. **Observe (`gather_market_data`):** Queries Aarna ATARS for technical signals and LunarCrush for sentiment.\n2. **Analyze (`analyze_with_llm`):** Evaluates signals using an LLM (e.g., Gemini or Claude) to return a structured decision (BUY, SELL, HOLD).\n3. **Act (`execute_trade`):** If a trade is decided, it calls the local Corax MCP to execute the trade.\n\n### How to use the Autonomous Orchestrator\n1. Ensure your API keys are set correctly in `.env` and your multi-MCP configuration.\n2. You can test the orchestrator locally:\n   ```bash\n   python3 autonomous_orchestrator.py\n   ```\n3. **Run 24/7 as a background service:**\n   We provide a systemd service template `systemd/corax_orchestrator.service`.\n   Copy it to your systemd folder, enable it, and start it to let your AI daemon trade fully autonomously:\n   ```bash\n   sudo cp systemd/corax_orchestrator.service /etc/systemd/system/\n   sudo systemctl daemon-reload\n   sudo systemctl enable --now corax_orchestrator.service\n   ```\n\n## 🗺️ System Overview \u0026 Architecture\n\nThe image series below illustrates the key stages of the Crypto MCP Server, bridging AI (Claude Desktop), local tools, and blockchain technology.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e1️⃣ Architectural Overview (Click to expand)\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\nClaude Desktop communicates via JSON-RPC with the Crypto MCP Server backend (REST + WebSocket). The server acts as a proxy, directing traffic to specific local MCP tools—such as CCXT, CoinGecko, and Portfolio—while logging orders to a local SQLite database.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"800\" alt=\"Architectural Overview\" src=\"./gui/frontend/public/images/architecture.jpg\" style=\"border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);\" onerror=\"this.style.display='none'\" /\u003e\n\u003c/div\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e2️⃣ Installation and Configuration (Click to expand)\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\nThe terminal displays successful execution steps of the automated `install.sh` script, automating directory creation, Node.js installation, and service setup.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"800\" alt=\"Installation and Configuration\" src=\"./gui/frontend/public/images/installation.jpg\" style=\"border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);\" onerror=\"this.style.display='none'\" /\u003e\n\u003c/div\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e3️⃣ Security and Best Practices (Click to expand)\u003c/b\u003e\u003c/summary\u003e\n\u003cbr\u003e\nSummarizes the core security principles: using testnet keys, securing API keys, restricting network access, leveraging local control, and implementing an authenticated reverse proxy.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"800\" alt=\"Security and Best Practices\" src=\"./gui/frontend/public/images/security.jpg\" style=\"border-radius: 12px; margin-bottom: 20px; border: 1px solid #333; box-shadow: 0 4px 15px rgba(0,255,150,0.1);\" onerror=\"this.style.display='none'\" /\u003e\n\u003c/div\u003e\n\u003c/details\u003e\n\n---\n\n## ✅ Quick start — automated\n\nPlace the provided `install.sh` into `$HOME/install.sh` (or `$HOME/cryptomcpserver/install.sh` if you prefer). Make it executable and run it:\n\n```bash\n# Save install.sh to $HOME/install.sh, then:\ncd $HOME\nchmod +x install.sh\n./install.sh\n```\n\n**What install.sh does (summary):**\n1. Creates directories and writes backend \u0026 frontend files.\n2. Installs Node.js if missing and runs `npm install` for backend \u0026 frontend.\n3. Ensures the `orders` table exists in `$HOME/cryptomcpserver/gui/backend/orders.db`.\n4. Frees port 4000 if occupied, then installs \u0026 enables the systemd service `crypto-mcp-gui.service`.\n5. Attempts a production build of the frontend.\n\n\u003e After running, check service status and logs:\n```bash\nsudo systemctl status crypto-mcp-gui.service\nsudo journalctl -u crypto-mcp-gui.service -f\n```\n\n---\n\n## 🛠 Manual install\n\nIf you prefer to do everything yourself:\n\n1. **Install system deps \u0026 Python Requirements:**\n   ```bash\n   sudo apt update\n   sudo apt install -y curl build-essential ca-certificates git python3-pip\n   pip3 install -r requirements.txt\n   ```\n\n   ```bash\n   sudo apt update\n   sudo apt install -y curl build-essential ca-certificates git\n   ```\n\n2. **Install Node.js (if needed):**\n   ```bash\n   curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -\n   sudo apt install -y nodejs\n   ```\n\n3. **Backend \u0026 Global Config:**\n   ```bash\n   cd $HOME/cryptomcpserver\n   cp .env.example .env\n   # edit .env to add your passwords, keys, and allowed pairs\n\n   cd gui/backend\n   npm install\n   ```\n\n4. **Frontend (dev):**\n   ```bash\n   cd $HOME/cryptomcpserver/gui/frontend\n   npm install\n   npm run dev -- --host   # open http://PI_IP:5173 on your laptop\n   ```\n\n5. **Systemd (backend):**\n   ```bash\n   # Create /etc/systemd/system/crypto-mcp-gui.service\n   sudo systemctl daemon-reload\n   sudo systemctl enable --now crypto-mcp-gui.service\n   ```\n\n---\n\n## ⚙️ Configuration\n\nThe system uses a centralized `.env` file located at the root of the project to manage both Python MCP servers and the Node.js backend.\n\nCopy and edit `$HOME/cryptomcpserver/.env.example` → `.env`:\n\n```env\n# Essential configuration\nPORT=4000\nDASHBOARD_PASSWORD=your_secure_password # Required for trading and AI reasoning\nALLOWED_PAIRS=BTC/USDT,SOL/USDT # Fail-closed security: only these pairs are allowed\nMAX_TRADE_USD=100.0 # Maximum allowed trade amount per transaction\n\n# API Keys\nBINANCE_API_KEY=your_key\nBINANCE_API_SECRET=your_secret\n```\n\n---\n\n## 🔗 Claude Desktop integration\n\n### Add MCP servers in Claude Desktop (step-by-step)\n1. Open Claude Desktop app.\n2. Open App Settings / Preferences.\n3. Find Local MCP Servers.\n4. Click `+` (Add) — fill fields one by one:\n   *   **Name:** `ccxt`\n   *   **Description:** `CCXT MCP – exchange trading \u0026 market data`\n   *   **Transport:** `http`\n   *   **Endpoint:** `http://127.0.0.1:7001/mcp` (if Claude runs on Pi) or `http://\u003cpi-ip\u003e:7001/mcp` (if Claude runs on laptop)\n5. Save. Repeat for other MCPs (`coingecko`, `portfolio`, `onchain`, `ta`, `notifier`, `llm`, etc.) with their respective ports.\n\n---\n\n## 🖥 Dashboard user manual\n\n*   📊 **Portfolio:** View aggregated balances \u0026 USD value (async fetching for speed).\n*   📈 **Ticker:** Live market data (via ccxt MCP).\n*   🛒 **Order / Trade:**\n    *   **Preview (dry_run):** Calculates estimated cost and logs a preview.\n    *   **Confirm → Place order:** Sends create_order to CCXT MCP (backend requires `execute:true`).\n*   📜 **Orders log:** Shows previews and executed orders (real-time updates via socket.io, paginated with indices).\n*   🤖 **AI Copilot:** Voice-activated command center powered by real local LLMs.\n\n\u003e ⚠️ **Safety:** Always test with testnet keys. The UI requires confirmation to execute live orders.\n\n---\n\n## 🔒 Security \u0026 best practices\n\n*   **Testnet First:** Use testnet keys while testing.\n*   **Environment Variables:** Keep API keys out of repo — store them in the MCP server config or in secure `.env` not committed.\n*   **Network Isolation:** Restrict access to MCP endpoints to LAN only (UFW rules) or use VPN/SSH tunnels.\n*   **Authentication:** Auth bypass vulnerabilities via insecure `req.ip` validation on localhost have been successfully patched. `/api/order/pending` and `/api/order/reasoning` endpoints are now fully secured with `DASHBOARD_PASSWORD` verification.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/PelleNybe/PelleNybe/main/assets/line.svg\" width=\"100%\" height=\"2\" onerror=\"this.style.display='none'\"/\u003e\n  \u003cp\u003e\u003ci\u003eStay Cypherpunk. Keep Building. ⚡\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 🤖 Autonomous Orchestrator Mode\n\nThe Autonomous Orchestrator Mode evolves the project from a passive Multi-MCP tool into an autonomous, 24/7 trading agent framework. It features a \"Board of Directors\" consensus logic, Telegram Command Center, and an Agentic Backtesting Engine. It runs a continuous Observe-Orient-Decide-Act (OODA) loop, connecting to external MCPs like Aarna ATARS and LunarCrush to gather market signals, and then utilizes an LLM to analyze the data and make trading decisions. The local Corax MCP is then instructed to execute trades if necessary.\n\nTo enable and configure the orchestrator, you can simply edit your `.env` file to select the LLM \"brain\" of your choice without editing any Python logic:\n\n```env\n# --- Autonomous Orchestrator Settings ---\n# Choose your provider: 'gemini', 'anthropic', or 'openai'\nACTIVE_LLM_PROVIDER=\"gemini\"\n\n# API Keys for the LLM providers (only the active one is required)\nGEMINI_API_KEY=\"your_google_gemini_key_here\"\nANTHROPIC_API_KEY=\"your_claude_api_key_here\"\nOPENAI_API_KEY=\"your_openai_api_key_here\"\n```\n\n### Proof of Brain / Trading Diary\n\nTo provide full transparency, the Autonomous Orchestrator includes a \"Proof of Brain\" module. After every complete OODA cycle (Observe, Analyze, Act), a comprehensive Markdown report is generated in the `trading_diary/` directory.\n\nThese reports document every decision made by the AI Board of Directors, answering *why* a specific action was taken. They include:\n*   The raw market data the orchestrator gathered from its MCPs.\n*   The individual votes and reasoning from the Technical Analyst (Gemini), Macro Strategist (OpenAI), and Risk Manager (Anthropic).\n*   The final consensus reached and execution parameters.\n\nReports are saved even if the board's decision is \"HOLD\", ensuring a fully auditable track record of the agent's logic.\n\n### Telegram Command Center\n\nThe Autonomous Orchestrator includes a built-in Telegram integration allowing you to receive real-time alerts and send commands to your trading agent.\n\n1.  **Create a Bot:** Talk to `@BotFather` on Telegram, create a new bot, and get the HTTP API Token.\n2.  **Get Chat ID:** Message your new bot, then go to `https://api.telegram.org/bot\u003cYourBOTToken\u003e/getUpdates` to find your `chat_id`.\n3.  **Update `.env`:**\n    ```env\n    TELEGRAM_BOT_TOKEN=\"your_token_here\"\n    TELEGRAM_CHAT_ID=\"your_chat_id_here\"\n    TELEGRAM_NOTIFICATIONS_ENABLED=\"true\"\n    ```\n\n**Available Commands:**\n*   `/status` - Returns the current active AI providers, the target ticker, and the last known decision.\n*   `/report` - Directly sends you the latest \"Proof of Brain\" markdown report as a document.\n*   `/analyze` - Manually triggers the agent to run an OODA cycle instantly without executing a trade.\n\n### Agentic Backtesting\n\nTo safely test the AI prompts and model configurations against past market behavior, we provide an Agentic Backtesting Engine. This allows you to simulate the \"Board of Directors\" consensus logic without risking real funds.\n\nThe backtest uses the `ccxt` library to fetch actual historical OHLCV data and simulates the market environment the orchestrator would have seen at that time.\n\n**To run a backtest:**\n```bash\npython3 backtest_orchestrator.py\n```\n\nAfter the simulation finishes, a detailed markdown report summarizing the starting period, ending period, total simulated actions (BUYS, SELLS, HOLDS), and the AI's reasoning will be generated in the `trading_diary/` directory (e.g., `YYYYMMDD_HHMMSS_[TICKER]_BACKTEST.md`).\n\nA `systemd/corax_orchestrator.service` template is provided to run the `autonomous_orchestrator.py` script as a 24/7 background daemon on Linux.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpellenybe%2Fcrypto-mcp-server---by-corax-colab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpellenybe%2Fcrypto-mcp-server---by-corax-colab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpellenybe%2Fcrypto-mcp-server---by-corax-colab/lists"}