/ Annuaire / Playground / maverick-mcp
● Communauté wshobson ⚡ Instantané

maverick-mcp

par wshobson · wshobson/maverick-mcp

Personal stock research with 39+ tools — technicals, screening, backtesting, sentiment — powered by Tiingo, yfinance, and FRED.

maverick-mcp by wshobson is a hobbyist's Bloomberg terminal for chat. Technical indicators (RSI, MACD, support/resistance), Maverick/Bear stock screeners, a VectorBT-powered backtester with 15+ strategies, portfolio tracking, and LLM-driven research. Bring-your-own-key for Tiingo (free tier); optional keys unlock web search and more models.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

maverick.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "maverick",
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "maverick": {
      "command": {
        "path": "uvx",
        "args": [
          "maverick-mcp"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add maverick -- uvx maverick-mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : maverick-mcp

Run a technical analysis check on a stock

👤 DIY traders, chart-pattern students ⏱ ~10 min intermediate

Quand l'utiliser : Before taking a position, you want indicators without opening TradingView.

Prérequis
  • TIINGO_API_KEY — tiingo.com — free tier covers casual use
Déroulement
  1. Pull full technicals
    Run get_full_technical_analysis on TSLA. RSI, MACD, key moving averages, support/resistance.✓ Copié
    → Tech dashboard
  2. Interpret in plain English
    Is this bullish, bearish, or neutral right now? Be specific about conviction.✓ Copié
    → Opinion with reasoning
  3. Sanity check
    What assumptions could be wrong? Where's the thesis most fragile?✓ Copié
    → Honest self-critique

Résultat : A reasoned technical view you can double-check against your own judgment.

Pièges
  • Technicals alone are not a strategy — Cross-check against fundamentals and news before acting
  • Backtest overfitting — Always validate on out-of-sample data
Combiner avec : yahoo-finance

Screen for candidates using Maverick screens

👤 Traders looking for setups ⏱ ~20 min intermediate

Quand l'utiliser : Weekly or daily screen for fresh ideas.

Déroulement
  1. Run the screen
    Run get_maverick_stocks — what's passing today?✓ Copié
    → Candidate list
  2. Triage
    For the top 10, get_full_technical_analysis each and rank by setup quality.✓ Copié
    → Ranked list with reasons

Résultat : A short watchlist derived from consistent criteria.

Backtest a strategy idea

👤 Strategy developers wanting quick feedback ⏱ ~25 min advanced

Quand l'utiliser : You have an idea like 'RSI cross above 50 with price above 200DMA' and want to see it on historical data.

Déroulement
  1. Run a backtest
    run_backtest: RSI-cross-above-50 + price>200DMA, SPY, 2015-2024, 10bps slippage.✓ Copié
    → Return stats + drawdown
  2. Compare to baseline
    compare_strategies: my strategy vs buy-and-hold SPY, same period.✓ Copié
    → Head-to-head

Résultat : Data-grounded view of whether an idea has legs.

Analyze your paper portfolio

👤 Long-term investors ⏱ ~20 min intermediate

Quand l'utiliser : Quarterly review: diversification, correlation, risk.

Déroulement
  1. Build portfolio
    portfolio_add_position for AAPL, MSFT, JNJ, VTI, GLD at current weights.✓ Copié
    → Portfolio object
  2. Correlation + risk
    portfolio_correlation_analysis and risk_adjusted_analysis.✓ Copié
    → Matrix + stats
  3. Recommendations
    What's overlapping? Where's concentration risk?✓ Copié
    → Diversification advice

Résultat : Actionable rebalancing ideas with justification.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

maverick + yahoo-finance

Pair maverick's technicals with Yahoo's raw fundamentals

Get maverick technical analysis on TSLA, plus Yahoo financial statements, and synthesize a thesis.✓ Copié
maverick + notion

Save research memos to Notion

Run research_comprehensive on AVGO; save the output as a Notion page under Investing / Research.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
fetch_stock_data ticker, start, end, interval? Base data fetch 1 Tiingo call
get_full_technical_analysis ticker: str One-stop technical view multiple calls
get_maverick_stocks (none) Weekly screening free (pre-seeded DB)
run_backtest strategy, ticker, start, end, params Validate a strategy idea CPU-bound
portfolio_add_position ticker, shares, cost_basis Track holdings free
portfolio_correlation_analysis (none) Diversification check CPU
research_comprehensive ticker: str Deep dive; more expensive LLM + web search calls
analyze_market_sentiment ticker or sector Context beyond price web search calls

Coût et limites

Coût d'exécution

Quota d'API
Tiingo free tier: 500 req/hr, 50k/mo. Depends on OPENROUTER/Anthropic keys if used for research.
Tokens par appel
Simple data: 500-2000. research_comprehensive: 10k+
Monétaire
Free tier covers hobbyist use; paid data + LLM keys for heavy research
Astuce
Enable Redis caching to avoid repeated Tiingo hits; OpenRouter saves 40-60% on LLM calls vs direct Anthropic.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Env vars: TIINGO_API_KEY, OPENROUTER_API_KEY, etc.
Sortie de données : Calls to Tiingo, Yahoo (via yfinance), FRED, plus whichever LLM/search keys you configure
Ne jamais accorder : Exposing the HTTP transport to the public internet

Dépannage

Erreurs courantes et correctifs

TIINGO_API_KEY missing

Create a free account at tiingo.com and set the env var.

Vérifier : echo $TIINGO_API_KEY
Backtest hangs

VectorBT is CPU-bound; long histories on minute bars can take 10+ min. Narrow the date range or use daily bars.

Redis not connecting

Redis is optional; unset REDIS_HOST to fall back to in-memory cache.

Vérifier : redis-cli ping

Alternatives

maverick-mcp vs autres

AlternativeQuand l'utiliserCompromis
yahoo-finance-mcpYou only need raw data and no technicals/backtestNo screens, no backtest, no portfolio
QuantConnect Lean / ZiplineYou need institution-grade backtestingNo MCP; steeper setup
TradingViewYou want a chart UINot programmatic; not MCP

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills