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:

Group	Tools
Aggregates / bars	`get_aggregates`, `get_previous_close`, `get_daily_market_summary`, `get_daily_ticker_summary`
Quotes & trades	`get_last_quote`, `get_last_trade`, `get_quotes`, `get_trades`
Snapshots	`get_snapshot`, `get_all_snapshots`, `get_top_movers`
Tickers / reference	`list_tickers`, `get_ticker_overview`, `get_related_tickers`, `list_ticker_types`
Market reference	`get_market_status`, `get_market_holidays`, `list_exchanges`, `list_condition_codes`
News	`get_news`
Indicators	`get_sma`, `get_ema`, `get_rsi`, `get_macd`
Corporate actions	`get_dividends`, `get_splits`, `get_ipos`, `get_ticker_events`
Financials	`get_financials`, `get_short_interest`, `get_short_volume`

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)

Skill	Role
`massive-trade-analysis`	Entry plan: HQ-tag setup, ATR-based zone, cascaded TPs, R:R-sized position
`market-macro-context-analysis`	SPY/QQQ regime score (used by trade-analysis as macro overlay)
`earnings-calendar-check`	Estimates next earnings date, flags trade-window overlap
`position-management`	Mid-trade decisions: trim/hold/trail/time-stop using MAE/MFE + R-multiple
`setup-edge-validation`	Backtests HQ tag rules empirically — replaces gut-feel probabilities

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:

Call mcp__massive__get_market_status and pull SPY/QQQ via market-macro-context-analysis → macro overlay
Pull NVDA bars + EMAs + RSI + MACD + news + ticker overview
Compute HQ tag, ATR, support/resistance, R:R via compute_rr.py
(Optional) call earnings-calendar-check to flag earnings overlap
(Optional) call setup-edge-validation for empirical scenario probabilities
Render the trade-plan markdown
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.

massive-mcp