AutoFinance: Your AI Financial Command Center, right inside the terminal!
Source: Dev.to
# GitHub Copilot CLI Challenge Submission
*This is a submission for the [GitHub Copilot CLI Challenge](https://dev.to/challenges/github-2026-01-21).*
---
## Why Leave the Terminal?
As developers, we live in the terminal. So why do we keep switching to 20 different browser tabs just to check market volatility, technical indicators, or portfolio drift?
I wanted to see if I could build a professional‑grade financial research desk that lives exactly where I do. The result is **AutoFinance**: a heavy‑duty orchestration of 13 specialized MCP (Model Context Protocol) servers that turn your command line into a high‑speed financial command center.
---
## Demo
*(Insert demo GIF or video here)*
---
## The 13‑Server Engine Room
To power these agents, I stood up 13 microservices using the Model Context Protocol. Each server handles a specific domain:
| Port | Server | Responsibility |
|------|------------|---------------------------------------------------|
| 9001 | **Market** | Real‑time data via Yahoo Finance & Binance |
| 9002 | **Risk** | Automated trade validation and position sizing |
| 9005 | **Technical** | Crunches RSI, MACD, and Bollinger Bands |
| 9006 | **Fundamental**| P/E ratios, ROE, and growth metrics |
| 9008 | **News** | Local sentiment analysis on market headlines |
| 9012 | **Simulation** | Monte Carlo scenarios for stress testing |
| … | … | … |
---
## Key Features
- **📈 Real‑Time Market Data** – Connects directly to **Yahoo Finance** and **Binance** (via WebSockets) to stream live prices. No staleness—just raw, real‑time data.
- **📡 Multi‑Channel Global Notifications** – Never miss a beat. The system pushes critical alerts to where you actually live:
- **Slack & Discord** – Trade confirmations, price spikes, and agent debates.
- **SMS & WhatsApp** – Urgent margin calls or crash alerts.
- **Email** – Daily portfolio summaries and audit reports.
- **🛡️ Automated Risk Guardrails** – The Risk Server enforces strict position limits (max 5 %) and stop‑losses automatically. It rejects any trade that violates your pre‑set safety policy.
- **💬 Natural Language Interface** – Deep `copilot` CLI integration lets you “chat” with your portfolio. *“Hey, sell half my Bitcoin if RSI > 80.”*
- **📊 Comprehensive Analysis**
- **Technical** – Real‑time RSI, MACD, and Bollinger Bands.
- **Fundamental** – P/E ratios, ROE, and growth metrics.
- **Sentiment** – Scans news headlines to gauge the current market mood.
---
## How GitHub Copilot CLI Saved My Sanity
It helped me build this project in less than **36 hours!!**
AutoFinance/ ├── .github/ # COPILOT BRAIN 🧠 │ ├── copilot-instructions.md # The “Bible” (Context & Rules) │ ├── mcp-config.json # Local MCP Server Config │ ├── agents/ # Specialized Personas │ │ ├── mcp-server-developer.md │ │ ├── financial-analyst.md │ │ ├── cli-dashboard-dev.md │ │ └── test-engineer.md │ ├── skills/ # Reusable Knowledge │ │ ├── financial-data-validation/ │ │ ├── mcp-server-debugging/ │ │ └── technical-analysis-impl/ │ ├── instructions/ # Path‑Specific Context │ │ ├── mcp-servers.md │ │ └── tests.md │ └── hooks/ # Automation Scripts │ └── hooks.json # Pre/Post‑execution logic ├── mcp-servers/ # THE 13 MICROSERVICES │ ├── market/ # Yahoo Finance Integration │ ├── technical/ # RSI/MACD/Bollinger Logic │ ├── sentiment/ # NewsAPI + LLM Analyzer │ ├── risk/ # Compliance & Limits Engine │ └── … (10 others) └── cli/ # The Textual Dashboard UI
*(I specifically organized `.github/` to leverage Copilot's ability to read configuration files. This ensures every suggestion respects the project's architecture.)*
Building a system with 13 microservices is not easy. Honestly, if I had to manually manage the boilerplate for every server, I’d still be writing imports.
### 1. The `@mcp-server-developer` Persona
I defined custom instructions so Copilot knew exactly how I wanted my MCP servers structured. When I needed the *Volatility Server*, I didn't write code; I just talked to my terminal:
```bash
copilot --agent=mcp-server-developer "Create a volatility server on port 9010 using our standard SSE transport."It generated the Pydantic models and error handling that matched the rest of my stack perfectly.
2. Local MCP Integration
I configured Copilot CLI to actually talk to my running AutoFinance servers. By mapping my local tools in ~/.copilot/mcp-config.json, I could ask the CLI real‑time questions:
Me: “What’s the current RSI for NVDA?”
Copilot: “The current RSI for NVDA is 72.4 (Overbought). Recommendation: Wait for a pullback.”
It bridged the gap between a coding assistant and a production console.
3. Living Documentation
Using .github/copilot-instructions.md, I gave Copilot the knowledge of the project—things like port ranges and a “no hard‑coded API keys” policy. This meant I never had to correct it on the small stuff. It just knew the architecture.
Screenshots
Landing UI
(Add additional screenshots as needed.)
## Dashboard
[](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Fbzarx0sg7p80p646hulh.png)
## Setup in 30 Seconds
```bash
git clone https://github.com/crypticsaiyan/AutoFinance.git
pip install -r mcp-servers/requirements.txt
pip install -r cli/requirements.txt
./start_sse_servers.sh # Fire up the 13‑server swarm
python cli/main.py # Launch the Command Center
# see the repo for more advanced setupI really enjoyed and learned a lot making this project (plus burnt a lot of credits too 😅)
Made by: crypticsaiyan