# Maverick MCP (MCP server)

> Maverick MCP is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Stock market MCP server for Yahoo Finance data, technical analysis, portfolio tracking, and Python backtesting. It has 710 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm ghcr.io/wshobson/maverick-mcp.

MaverickMCP is an open-source stock market MCP server for stock analysis, portfolio tracking, and Python backtesting. It connects an AI assistant to Yahoo Finance data through yfinance, with no API key required for core tools. The server runs on your computer and stores your portfolio, watchlists, and trade journal in a local database.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/wshobson/maverick-mcp |
| GitHub stars | 710 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | docker: ghcr.io/wshobson/maverick-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Finance |
| Latest release | v1.2.1 (Oct 17, 2026) |
| Last commit | Oct 17, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "maverick-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wshobson/maverick-mcp"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio maverick-mcp -- docker run -i --rm ghcr.io/wshobson/maverick-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "maverick-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wshobson/maverick-mcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "maverick-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wshobson/maverick-mcp"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `market_data_get_price_history`: OHLCV price history for a ticker, stored locally and refreshed on access.
- `market_data_get_price_history_batch`: Price history for multiple tickers at once.
- `market_data_get_quote`: A single quote, cached briefly. Returns an error when Yahoo has no price for the ticker (delisted or unknown).
- `market_data_get_stock_fundamentals`: Valuation, financials, and trading stats.
- `market_data_get_market_overview`: Indices, sector performance, top movers, and volatility.
- `market_data_get_chart_links`: Static external chart links for a ticker.
- `market_data_clear_market_cache`: Clear cached quotes (mutates cache state).
- `technical_get_rsi_analysis`: RSI reading and signal label.
- `technical_get_macd_analysis`: MACD reading, signal label, and crossover state.
- `technical_get_support_resistance`: Observed price extrema over the requested history.
- `technical_get_full_technical_analysis`: Trend, outlook, and technical indicators.
- `screening_get_bullish`: Top Maverick bullish-momentum results, latest snapshot.
- `screening_get_bearish`: Top bearish setup results, latest snapshot.
- `screening_get_supply_demand`: Top supply/demand breakout results, latest snapshot.
- `screening_get_all`: Latest snapshot across all three screens.
- `screening_get_by_criteria`: Bullish results filtered by arbitrary criteria.
- `screening_run_screens`: Recompute one screen (or all three) and persist it (mutates).
- `portfolio_add_position`: Add/average into a position (mutates).
- `portfolio_get_my_portfolio`: Portfolio snapshot with P&L using current available quotes.
- `portfolio_remove_position`: Remove shares from a position (mutates).
- `portfolio_clear_portfolio`: Remove every position; requires confirm=True (mutates).
- `portfolio_risk_adjusted_analysis`: ATR-based position sizing/stop/target.
- `portfolio_compare_tickers`: Ticker comparison, using your portfolio when tickers are omitted.
- `portfolio_correlation_analysis`: Correlation matrix and diversification metrics.
- `portfolio_get_risk_dashboard`: Total value, sector exposure, and risk metrics.
- `portfolio_check_position_risk`: Pre-trade risk check for a hypothetical trade.
- `portfolio_get_regime_adjusted_sizing`: Position size scaled by detected market regime.
- `portfolio_get_risk_alerts`: Current sector/position/portfolio risk alerts.
- `portfolio_watchlist_list`: List watchlist IDs and names.
- `portfolio_watchlist_create`: Create a named watchlist (mutates).
- `portfolio_watchlist_add`: Add a ticker to a watchlist (mutates).
- `portfolio_watchlist_remove`: Remove a ticker from a watchlist (mutates).
- `portfolio_watchlist_brief`: Quotes and analysis for the symbols on a watchlist.
- `portfolio_journal_add_trade`: Log a new open trade; optional ISO entrydate records a past trade (mutates).
- `portfolio_journal_close_trade`: Close an open trade; profit or loss calculated automatically (mutates).
- `portfolio_journal_list_trades`: List journal trades, optionally filtered.
- `portfolio_journal_review`: Full detail for a single journal trade.
- `portfolio_get_strategy_performance`: Strategy performance analytics, with optional comparison.
- `backtesting_run_backtest`: Run a single-strategy backtest: metrics, trades, analysis.
- `backtesting_optimize_strategy`: Grid-search a strategy's parameters.

## Similar MCP servers

- [Yahoo Finance2](https://appsgit.com/mcp-servers/yahoo-finance2): Unofficial API for Yahoo Finance with CLI, MCP and Agent Skill. (809 stars, MIT)
- [Emilia Protocol](https://appsgit.com/mcp-servers/emilia-protocol): Exact-action approval for consequential agent actions: request, track, and verify signed receipts. (599 stars, Apache-2.0, needs API key)
- [Attestix](https://appsgit.com/mcp-servers/attestix): AI agent identity, signed credentials, delegated authority and governance evidence. (837 stars, Apache-2.0, official)
- [Oracle3 prediction-market arbitrage checks](https://appsgit.com/mcp-servers/oracle3-prediction-market-arbitrage-checks): Kalshi and Polymarket data, venue fees, no-arbitrage checks and paper execution for AI agents. (522 stars, Apache-2.0)
- [CNEquity](https://appsgit.com/mcp-servers/cnequity): China A-share data lake for AI agents: prices, fundamentals, flows and events, point-in-time. (868 stars, Apache-2.0)
- [Polymarket Paper Trader](https://appsgit.com/mcp-servers/polymarket-paper-trader): Polymarket paper trading for AI agents: $10k paper money, real order books, official fees. (492 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/maverick-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.