Skip to content
appsgit

Maverick MCP

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.

github.com/wshobson/maverick-mcp (opens in a new tab)

Data as of from the GitHub API; description from the project's repository. Report an error

Install Maverick MCP

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "servers": {
    "maverick-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wshobson/maverick-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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.

About 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.

  • anthropic
  • claude
  • finance
  • financial-analysis
  • mcp
  • mcp-server
  • python
  • technical-analysis
  • fastmcp
  • stock-market

FAQ

Maverick MCP FAQ

Still curious? Email info@appsgit.com.

How do I install the Maverick MCP MCP server?

Add the command docker run -i --rm ghcr.io/wshobson/maverick-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Maverick MCP free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Maverick MCP actively maintained?

The most recent commit was on Oct 17, 2026. The latest release is v1.2.1, published Oct 17, 2026. appsgit only lists MCP servers with a commit in the last six months.