maverick-mcp MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

39+ tools across analysis, portfolio, screening, research, backtesting
VectorBT backtesting engine with 15+ prebuilt strategies
Pre-seeded DB of 520 S&P 500 stocks with screening recommendations
Optional Redis cache for 7-256x speedup on repeated queries
Supports STDIO, HTTP, SSE transports

Demo ao vivo

Como fica na prática

maverick.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "maverick": {
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "maverick",
      "command": "uvx",
      "args": [
        "maverick-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "maverick": {
      "command": {
        "path": "uvx",
        "args": [
          "maverick-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add maverick -- uvx maverick-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: maverick-mcp

Run a technical analysis check on a stock

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

Quando usar: Before taking a position, you want indicators without opening TradingView.

Pré-requisitos

TIINGO_API_KEY — tiingo.com — free tier covers casual use

Fluxo

Pull full technicals

Run get_full_technical_analysis on TSLA. RSI, MACD, key moving averages, support/resistance.✓ Copiado

→ Tech dashboard
Interpret in plain English

Is this bullish, bearish, or neutral right now? Be specific about conviction.✓ Copiado

→ Opinion with reasoning
Sanity check

What assumptions could be wrong? Where's the thesis most fragile?✓ Copiado

→ Honest self-critique

Resultado: A reasoned technical view you can double-check against your own judgment.

Armadilhas

Technicals alone are not a strategy — Cross-check against fundamentals and news before acting
Backtest overfitting — Always validate on out-of-sample data

Combine com: yahoo-finance

Screen for candidates using Maverick screens

👤 Traders looking for setups ⏱ ~20 min intermediate

Quando usar: Weekly or daily screen for fresh ideas.

Fluxo

Run the screen

Run get_maverick_stocks — what's passing today?✓ Copiado

→ Candidate list
Triage

For the top 10, get_full_technical_analysis each and rank by setup quality.✓ Copiado

→ Ranked list with reasons

Resultado: A short watchlist derived from consistent criteria.

Backtest a strategy idea

👤 Strategy developers wanting quick feedback ⏱ ~25 min advanced

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

Fluxo

Run a backtest

run_backtest: RSI-cross-above-50 + price>200DMA, SPY, 2015-2024, 10bps slippage.✓ Copiado

→ Return stats + drawdown
Compare to baseline

compare_strategies: my strategy vs buy-and-hold SPY, same period.✓ Copiado

→ Head-to-head

Resultado: Data-grounded view of whether an idea has legs.

Analyze your paper portfolio

👤 Long-term investors ⏱ ~20 min intermediate

Quando usar: Quarterly review: diversification, correlation, risk.

Fluxo

Build portfolio

portfolio_add_position for AAPL, MSFT, JNJ, VTI, GLD at current weights.✓ Copiado

→ Portfolio object
Correlation + risk

portfolio_correlation_analysis and risk_adjusted_analysis.✓ Copiado

→ Matrix + stats
Recommendations

What's overlapping? Where's concentration risk?✓ Copiado

→ Diversification advice

Resultado: Actionable rebalancing ideas with justification.

Combinações

Combine com outros MCPs para 10× de alavancagem

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.✓ Copiado

maverick + notion

Save research memos to Notion

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

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
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

Custo e limites

O que custa rodar

Cota de API: Tiingo free tier: 500 req/hr, 50k/mo. Depends on OPENROUTER/Anthropic keys if used for research.
Tokens por chamada: Simple data: 500-2000. research_comprehensive: 10k+
Monetário: Free tier covers hobbyist use; paid data + LLM keys for heavy research
Dica: Enable Redis caching to avoid repeated Tiingo hits; OpenRouter saves 40-60% on LLM calls vs direct Anthropic.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Env vars: TIINGO_API_KEY, OPENROUTER_API_KEY, etc.

Saída de dados: Calls to Tiingo, Yahoo (via yfinance), FRED, plus whichever LLM/search keys you configure

Nunca conceda: Exposing the HTTP transport to the public internet

This is personal research software — not investment advice, no audit trail suitable for fiduciary use.
Paper-trade results do not guarantee live performance.

Solução de problemas

Erros comuns e correções

TIINGO_API_KEY missing

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

Verificar: 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.

Verificar: redis-cli ping

Alternativas

maverick-mcp vs. outros

Alternativa	Quando usar	Troca
yahoo-finance-mcp	You only need raw data and no technicals/backtest	No screens, no backtest, no portfolio
QuantConnect Lean / Zipline	You need institution-grade backtesting	No MCP; steeper setup
TradingView	You want a chart UI	Not programmatic; not MCP

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills