SwinGrade-MCPs

A collection of MCP servers and Claude skills for professional stock analysis. Built around a structured swing/long-term trading workflow that pulls live market data, technical indicators, financials, news, and chart visualizations — and turns them into actionable trade plans with explicit entry/SL/TP/R:R/sizing.

The repo contains:

• MCP servers that expose external data + chart APIs as tools

• Claude skills that orchestrate those tools into trade-grade analysis workflows

Designed for Claude Desktop and Claude Code.

Repository layout

SwinGrade-MCPs/
├── src/massive_mcp/         ← MCP #1: massive-mcp (Massive.com Stocks REST API)
├── tests/                   ← tests for massive-mcp
├── pyproject.toml           ← massive-mcp package
│
├── chart-img-mcp/           ← MCP #2: chart-img-mcp (TradingView chart snapshots)
│   ├── src/chart_img_mcp/
│   ├── tests/
│   └── pyproject.toml
│
└── skills/                  ← Claude skills that drive the workflow
    ├── massive-trade-analysis/
    ├── market-macro-context-analysis/
    ├── earnings-calendar-check/
    ├── position-management/
    └── setup-edge-validation/

Layout note: massive-mcp is at the repo root (legacy from when the repo started as just that MCP), while chart-img-mcp lives in its own subdirectory. Future MCPs will follow the subdirectory pattern.

MCP servers

massive-mcp — Massive.com Stocks REST API

Wraps Massive.com (Polygon-style). 31 tools across:

Install:

python -m venv .venv
.venv/Scripts/python -m pip install -e .   # Windows
# or .venv/bin/python -m pip install -e .   # mac/linux

Then in Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "massive": {
      "command": "C:\\path\\to\\SwinGrade-MCPs\\.venv\\Scripts\\massive-mcp.exe",
      "env": {
        "MASSIVE_API_KEY": "your_key",
        "MASSIVE_AUTH_MODE": "bearer"
      }
    }
  }
}

chart-img-mcp — TradingView chart snapshots

Wraps chart-img.com. 5 tools: generate_chart, generate_mini_chart, generate_chart_to_storage, list_exchanges, find_symbol. Returns images inline in Claude Desktop, plus optional CDN URLs.

See chart-img-mcp/README.md for install + config.

Claude skills

The skills live in skills/ and compose into a complete trading workflow:

                ┌─ market-macro-context-analysis  (regime score 0–10)
                │
massive-trade-analysis ─┼─ earnings-calendar-check  (pre-trade safety)
   (ENTRY plan)         │
                        ├─ setup-edge-validation    (empirical hit rates)
                        │
                        └─ chart-img: generate_chart (visual chart inline)
                              ↓
                    [trade is open]
                              ↓
                position-management        (TRIM / HOLD / EXIT)

Install: copy skills/* to ~/.claude/skills/. Full instructions in skills/README.md.

End-to-end example

After installing both MCPs and all skills, ask Claude Desktop:

"Swing trade plan for NVDA, $50k account"

The massive-trade-analysis skill will:

1. Call mcp__massive__get_market_status and pull SPY/QQQ via market-macro-context-analysis → macro overlay

2. Pull NVDA bars + EMAs + RSI + MACD + news + ticker overview

3. Compute HQ tag, ATR, support/resistance, R:R via compute_rr.py

4. (Optional) call earnings-calendar-check to flag earnings overlap

5. (Optional) call setup-edge-validation for empirical scenario probabilities

6. Render the trade-plan markdown

7. Call mcp__chart-img__generate_chart to attach a daily candle chart with EMA10/20/50/200 + RSI + MACD inline

You get a structured plan and the actual chart, side by side.

Prerequisites

• Python 3.10+ on PATH

• API keys:

  • Massive.com: https://massive.com/docs

  • chart-img.com: https://chart-img.com/dashboard

Why a single repo?

These pieces are designed to compose. Splitting them across repos forces users to clone N projects to get one workflow. Keeping them together means one git clone gets you the full toolchain — and the skills can reference the MCPs directly because they're co-located.

License

MIT — see individual MCP pyproject.toml files.