Skip to main content
Glama
MaverickMCP

MaverickMCP

by wshobson

MaverickMCP: stock market MCP server for local analysis

CI Python 3.12+ License: MIT

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.

MCP means Model Context Protocol, the standard that lets an AI assistant call external tools. Use MaverickMCP with clients such as Claude Desktop, Codex, Cursor, and VS Code. Optional packages add backtesting and financial research with a language model and web search.

MaverickMCP is for educational and informational use. It does not place orders or provide financial advice. Market data can be delayed, incomplete, or wrong.

Features

Area

What you can do

Market data and technical analysis

Get quotes, historical prices, fundamentals, RSI, MACD, and observed support and resistance levels.

Stock screening

Run bullish, bearish, and supply/demand screens over symbols you have loaded.

Portfolio tracking

Record positions, calculate average cost and profit or loss, review risk, manage watchlists, and keep a trade journal.

Optional backtesting and research

Test strategies on historical data, compare results, or research companies and sectors with source citations.

The v1.2.1 release has 38 core tools, 12 optional backtesting tools, and 3 optional research tools.

Daily history supports US stock symbols and the exchange suffixes .L, .T, .TO, .AX, .HK, and .DE. Other exchange suffixes return a calendar error for history and tools that depend on it. Quote and fundamentals lookups still use the symbols accepted by Yahoo Finance. See the history coverage and freshness guide.

Related MCP server: Trading MCP Server

Quick start

Install Python 3.12 or later and uv. SQLite is included. Redis and PostgreSQL are optional.

Installation

First, clone the repository and install the core tools.

git clone https://github.com/wshobson/maverick-mcp.git
cd maverick-mcp
uv sync
cp .env.example .env

Second, add optional packages if you need backtesting or research.

uv sync --extra backtesting --extra research

Third, connect your MCP client using the command below. Replace the path with the absolute path to your checkout. A client using STDIO starts the server itself, so no separate server process is needed.

uv run --directory /absolute/path/to/maverick-mcp maverick-mcp --transport stdio

The PyPI name maverick-mcp-server belongs to an unrelated project while the name-transfer request is pending. Do not install that name from PyPI. Run the release from its Git tag instead.

uvx --from "git+https://github.com/wshobson/maverick-mcp@v1.2.1" maverick-mcp --transport stdio

Connect your MCP client

Choose STDIO for one local client, or Streamable HTTP for clients that share a server process. For HTTP, run make dev and use http://localhost:8003/mcp. The endpoint has no trailing slash. /mcp/ redirects and can break registration.

A client that uses a mcpServers JSON configuration can launch the local checkout with the following entry.

{
  "mcpServers": {
    "maverick-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/maverick-mcp",
        "maverick-mcp",
        "--transport",
        "stdio"
      ]
    }
  }
}

Configuration formats vary by client. The MCP client setup guide covers Claude Desktop, Claude Code, Codex, Cursor, VS Code, GitHub Copilot CLI, OpenCode, and other clients. Use the guide for the exact file location and keys.

HTTP binds to 127.0.0.1 by default. The server has no authentication, so keep it local unless you have configured separate access controls.

Docker with persistent data

Build the image from source as shown below, or run the published ghcr.io/wshobson/maverick-mcp:1.2.1 image with the same options.

cp .env.example .env
docker build -t maverick-mcp:local .
docker run --rm --name maverick-mcp \
  -p 127.0.0.1:8003:8000 \
  --env-file .env \
  --mount source=maverick-data,target=/data \
  maverick-mcp:local

The named volume keeps your database and cache when the container is replaced. The image stores them at /data/maverick.db and /data/maverick_cache.db and runs as user 1000. A bind-mounted directory must be writable by that user. For PostgreSQL, set DATABASE_URL explicitly. The POSTGRES_URL fallback does not override the image's DATABASE_URL default. The image includes both optional packages.

If you used an older container, back up its databases under /app before removing it. See Docker data storage and migration for backup instructions and PostgreSQL overrides. Do not mount a volume over /app, which contains the installed application.

Tools

The tables list tool names as they appear to an MCP client. Tools marked "mutates" change stored data or cache state. A portfolio entry or journal trade is a local record and does not submit an order to a broker.

Market data

Tool

Description

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 analysis

Tool

Description

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.

Stock screening

Tool

Description

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

Fetch price history for the symbols you want to screen, then run a screen. A quote lookup does not add a symbol to the screening universe. A new database has no default stock universe. See the database setup guide.

Portfolio tracking, watchlists, and trade journal

Tool

Description

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

Tools that accept an optional ticker list use your portfolio when it is omitted. See portfolio behavior and precision for details.

Python backtesting (backtesting extra)

Tool

Description

backtesting_run_backtest

Run a single-strategy backtest: metrics, trades, analysis.

backtesting_optimize_strategy

Grid-search a strategy's parameters.

backtesting_walk_forward_analysis

Rolling optimize/test windows to gauge robustness.

backtesting_monte_carlo_simulation

Bootstrap-resample trades for a return/drawdown distribution.

backtesting_compare_strategies

Backtest multiple strategies on the same symbol and rank them.

backtesting_list_strategies

List every rule-based strategy template with default parameters.

backtesting_backtest_portfolio

Backtest one strategy across multiple symbols.

backtesting_parse_strategy

Parse a natural-language description into a strategy + parameters (BYOK LLM).

backtesting_run_ml_strategy_backtest

Backtest a machine learning strategy (predictor, adaptive, ensemble, or regime).

backtesting_train_ml_predictor

Train a random-forest ML predictor for trading signals.

backtesting_analyze_market_regimes

Detect bear/sideways/bull regimes for a symbol.

backtesting_create_strategy_ensemble

Backtest a weighted ensemble of base strategies.

The extra includes 12 strategy templates plus machine learning models and strategies. Install it with uv sync --extra backtesting. Without the extra, no backtesting_* tools are registered. See the backtesting API reference for metric definitions, strategy parameters, and output limits.

Financial research (research extra)

Tool

Description

research_run_comprehensive

Web research on a financial topic, with source citations.

research_analyze_company

Company research, with source citations.

research_analyze_sentiment

Market sentiment analysis for a topic or sector.

Install with uv sync --extra research, then configure a language model and Exa or SearXNG web search. Without the extra, no research_* tools are registered. Research returns source citations and an explicit error when no usable evidence remains. See research setup and behavior.

Configuration

Use environment variables or a .env file. The .env.example file lists the supported settings.

Setting

Purpose

DATABASE_URL

Select SQLite or PostgreSQL. Local processes default to sqlite:///maverick.db; containers default to sqlite:////data/maverick.db.

REDIS_HOST

Enable Redis caching. Otherwise the server uses memory and SQLite.

LLM_PROVIDER, LLM_API_KEY, LLM_MODEL

Configure the language model for research and natural-language strategy parsing.

LLM_BASE_URL

Set a custom endpoint, required for openai_compatible.

LLM_TEMPERATURE

Optionally override the model's sampling temperature. Omit it to use the provider default.

EXA_API_KEY

Enable Exa web search for research.

RESEARCH_SEARCH_BACKEND, SEARXNG_BASE_URL

Use searxng with a server that supports JSON responses instead of Exa.

Supported model providers are anthropic, openai, openrouter, and openai_compatible. Core tools do not require a model API key. Optional research can incur charges from your model and search providers.

Usage examples

Once connected, ask your assistant to use the tools. Include the dates, symbols, and prices needed for a request.

  • "Get RSI and MACD for NVDA, then show the observed price range for the last 90 days."

  • "Fetch one year of AAPL and MSFT price history, then run the bullish screen."

  • "List my watchlists and show my portfolio with current prices."

  • "Backtest the SMA crossover strategy on SPY from January 1, 2024 to January 1, 2025."

The analyze_stock and review_portfolio prompts provide guided workflows. Installing the backtesting extra also adds run_backtest_workflow. The portfolio://my-holdings resource exposes a snapshot of your default portfolio.

Common questions

Does the Yahoo Finance connection need an API key?

No. Core market data uses yfinance. Data availability and delays depend on Yahoo Finance, and requests can fail or be rate limited. Market movers use finviz. Neither source is an execution feed for placing orders.

Why does stock screening return no results?

A new database has no stock universe. Fetch price history for your chosen tickers, then call screening_run_screens. A quote request alone does not register a ticker for screening.

Why are backtesting or research tools missing?

Install the corresponding extra in the environment your MCP client starts, then restart the server. Research also needs a configured model and search backend. See the research setup guide.

Why does an HTTP client fail to connect?

Use http://localhost:8003/mcp, without a trailing slash, and check that the server is running. A STDIO client should launch its own process instead. See client troubleshooting.

Development

Install the development tools and optional packages before running all checks.

uv sync --extra dev --extra backtesting --extra research
make test
make lint
make typecheck
make docs-check

make test excludes tests marked integration, slow, or external. See the testing guide for focused tests and integration checks. Run provider tests only with the required credentials and consent.

Read the architecture before adding a tool, and keep business logic in its domain service. The contributing guide describes the review process. Current work and remaining limitations are recorded in the documentation index and debt tracker.

Help and license

Report problems in GitHub issues with the command, version, and error message. Remove credentials and personal portfolio data from logs before sharing them. Use the security policy for vulnerability reports.

MaverickMCP uses FastMCP, yfinance, vectorbt, and LangGraph. The project is licensed under the MIT License.

Disclaimer

MaverickMCP provides educational information, not financial, investment, or tax advice. Historical backtests and technical indicators do not predict future returns. Market data and generated research can contain errors. Verify the underlying sources before using an analysis to make a decision.

Available Tools

119 tools
add_portfolio_positionC

Add a position to your portfolio with automatic cost basis averaging.

Inputs: ticker (required), shares (required), purchase_price (required), purchase_date, +1 more. Returns: object

agents_analyze_market_with_agentC

Analyze market conditions using an AI agent with specified persona and strategy.

Inputs: query (required), persona, screening_strategy, max_results, +1 more. Returns: object

agents_compare_multi_agent_analysisC

Compare analysis results from multiple agent types side by side.

Inputs: query (required), agent_types, persona, session_id. Returns: object

agents_compare_personas_analysisC

Compare analysis results across different investor personas.

Inputs: query (required), session_id. Returns: object

agents_deep_research_financialC

Perform deep financial research on a topic with AI agents.

Inputs: research_topic (required), persona, research_depth, focus_areas, +2 more. Returns: object

agents_get_agent_streaming_analysisC

Get streaming analysis from an AI agent for real-time updates.

Inputs: query (required), persona, stream_mode, session_id. Returns: object

agents_list_available_agentsA

List all available LangGraph agents and their capabilities.

Returns: Information about available agents and personas

Inputs: no named parameters. Returns: object

agents_orchestrated_analysisC

Perform orchestrated multi-agent analysis with intelligent routing.

Inputs: query (required), persona, routing_strategy, max_agents, +2 more. Returns: object

analyze_market_regimesC

Analyze market regimes for a stock using ML methods.

Inputs: symbol (required), start_date, end_date, method, +2 more. Returns: object

backtest_portfolioC

Backtest a strategy across multiple symbols (portfolio).

Inputs: symbols (required), strategy, start_date, end_date, +5 more. Returns: object

backtest_signalA

Backtest a saved signal definition against historical OHLCV data. Walks the data bar-by-bar through the live signal evaluation engine so the entry/exit edges match what the signal would produce in production. Returns trade list and summary metrics (total return, win rate, Sharpe, max drawdown).

Inputs: signal_id (required), start_date (required), end_date (required), initial_capital. Returns: object

check_signals_nowA

Manually trigger evaluation of all active signals against current market data. Returns a list of evaluation results including which signals triggered.

Inputs: no named parameters. Returns: object

compare_strategiesC

Compare multiple strategies on the same symbol.

Inputs: symbol (required), strategies, start_date, end_date. Returns: object

compare_tickersA

Compare stocks side-by-side with technical metrics.

If no tickers provided, automatically compares all portfolio holdings.

Inputs: tickers, days. Returns: object

create_signalA

Create a persistent price/indicator alert signal. The condition dict must specify 'indicator' (price, rsi, volume, sma), 'operator' (lt, gt, lte, gte, spike, crosses_above, crosses_below), and 'threshold' (numeric, not needed for spike).

Inputs: label (required), ticker (required), condition (required), interval_seconds. Returns: object

create_strategy_ensembleB

Create and backtest a strategy ensemble across multiple symbols.

Inputs: symbols (required), base_strategies, weighting_method, start_date, +2 more. Returns: object

data_clear_cacheA

Clear cached data for a specific ticker or all tickers.

This tool helps manage the local cache by removing stored data, forcing fresh data retrieval on the next request.

Inputs: ticker. Returns: object

data_fetch_stock_dataC

Fetch historical stock data for a given ticker symbol.

This is the primary tool for retrieving stock price data. It uses intelligent caching to minimize API calls and improve performance.

Updated to use separated services following Single Responsibility Principle.

Inputs: ticker (required), start_date, end_date. Returns: object

data_fetch_stock_data_batchA

Fetch historical data for multiple tickers efficiently.

This tool fetches data for multiple stocks in a single call, which is more efficient than calling fetch_stock_data multiple times.

Updated to use separated services following Single Responsibility Principle.

Inputs: tickers (required), start_date, end_date. Returns: object

data_get_adanos_market_sentimentC

Get optional Adanos market sentiment data for stocks.

Inputs: ticker, days, sources. Returns: object

data_get_cached_price_dataA

Get cached price data directly from the database.

This tool retrieves data from the local cache without making external API calls. Useful for checking what data is available locally.

Inputs: ticker (required), start_date (required), end_date. Returns: object

data_get_news_sentimentA

Get news sentiment analysis for a stock using Tiingo News API or LLM analysis.

This enhanced tool provides reliable sentiment analysis by:

  • Using Tiingo's news API if available (requires paid plan)

  • Analyzing sentiment with LLM (Claude/GPT)

  • Falling back to research-based sentiment

  • Never failing due to missing EXTERNAL_DATA_API_KEY

Inputs: ticker (required), timeframe, limit.

data_get_stock_infoB

Get detailed fundamental information about a stock.

This tool retrieves comprehensive stock information including:

  • Company description and sector

  • Market cap and valuation metrics

  • Financial ratios

  • Trading information

Inputs: ticker (required). Returns: object

delete_signalB

Delete a signal alert by ID.

Inputs: signal_id (required). Returns: object

discover_capabilitiesA

Discover all available capabilities of the MaverickMCP server.

This tool provides comprehensive information about:

  • Available strategies (traditional and ML)

  • Tool categories and their functions

  • Parameter requirements for each strategy

  • Example usage patterns

Use this as your first tool to understand what's available.

Inputs: no named parameters. Returns: object

fetch_stock_dataB

Fetch historical OHLCV price data for a stock.

Inputs: ticker (required), start_date, end_date. Returns: object

generate_backtest_chartsC

Generate comprehensive charts for a backtest.

Inputs: symbol (required), strategy, start_date, end_date, +1 more. Returns: object

generate_optimization_chartsC

Generate chart for strategy parameter optimization.

Inputs: symbol (required), strategy, start_date, end_date, +1 more. Returns: object

get_adanos_market_sentimentC

Get optional Adanos sentiment from Reddit, X / FinTwit, News, and Polymarket.

Inputs: ticker, days, sources. Returns: object

get_all_screening_recommendationsA

Run all screening strategies and return combined results.

Returns bullish, bearish, and breakout candidates in a single response.

Inputs: no named parameters. Returns: object

get_circuit_breaker_statusA

Get status of all circuit breakers.

Returns information about circuit breaker states, failure counts, and performance metrics for all external API connections.

Returns: Dictionary containing circuit breaker status information

Inputs: no named parameters. Returns: object

get_component_statusB

Get status of a specific component or all components.

Inputs: component_name. Returns: object

get_decision_logB

Query the agent decision audit trail.

Returns recent decision records showing query classifications, agent routing, token usage, cost estimates, and outcomes.

Inputs: session_id, limit. Returns: object

get_economic_calendarC

Get upcoming economic events and indicators.

Provides full access to economic calendar data.

Inputs: days_ahead. Returns: object

get_full_technical_analysisC

Full technical analysis: RSI, MACD, Bollinger Bands, SMA/EMA, volume, S/R levels.

Inputs: ticker (required), days. Returns: object

get_health_historyA

Get historical health data for trend analysis.

Returns recent health check history including component status changes, resource usage trends, and system performance over time.

Returns: Dictionary containing historical health information

Inputs: no named parameters. Returns: object

get_macd_analysisB

Get MACD crossover signals and divergence analysis.

Inputs: ticker (required), fast_period, slow_period, signal_period, +1 more. Returns: object

get_market_overviewB

Get comprehensive market overview including indices, sectors, and market breadth.

Provides full market data without restrictions.

Inputs: no named parameters. Returns: object

get_market_regimeA

Detect the current market regime (bull, bear, choppy, or transitional) using SPY price data and a composite multi-factor scoring model.

Inputs: no named parameters. Returns: object

get_maverick_bear_stocksB

Screen for bearish/short setup candidates from S&P 500.

EDUCATIONAL USE ONLY - not investment advice.

Inputs: limit. Returns: object

get_maverick_stocksB

Screen S&P 500 for bullish momentum setups.

EDUCATIONAL USE ONLY - not investment advice.

Inputs: limit. Returns: object

get_mcp_connection_statusA

Get current MCP connection status for debugging connection stability issues.

Returns detailed information about active connections, tool registration status, and connection health metrics to help diagnose disappearing tools.

Inputs: no named parameters. Returns: object

get_my_portfolioA

Get all portfolio positions with live P&L calculations.

Inputs: include_current_prices. Returns: object

get_news_sentimentA

Get news sentiment analysis for a stock.

Uses Tiingo News API or LLM-based analysis with fallback.

Inputs: ticker (required), timeframe, limit. Returns: object

get_portfolio_risk_dashboardB

Compute a full risk dashboard for the named portfolio. Returns total value, sector concentration, parametric VaR (95 and 99 confidence), and total unrealised P&L.

Inputs: portfolio_name. Returns: object

get_position_risk_checkA

Pre-trade risk check: shows how adding a new position would affect portfolio risk. Returns current vs projected metrics including sector concentration and VaR.

Inputs: ticker (required), shares (required), entry_price (required), portfolio_name. Returns: object

get_regime_adjusted_sizingA

Calculate position size adjusted for current market regime. Detects regime from SPY data, then scales risk percentage accordingly: bull = full risk, choppy/transitional = 75%, bear = 50%.

Inputs: account_size (required), entry_price (required), stop_loss (required), risk_pct. Returns: object

get_regime_historyC

Retrieve recorded market regime events from the database.

Inputs: days. Returns: object

get_resource_usageA

Get current system resource usage.

Returns information about CPU, memory, disk usage, and other system resources being consumed by the backtesting system.

Returns: Dictionary containing resource usage information

Inputs: no named parameters. Returns: object

get_risk_alertsA

Generate current risk alerts for the named portfolio. Checks for sector concentration (>30% warning, >50% critical), oversized positions (>20%), and portfolio drawdown (>10% loss).

Inputs: portfolio_name. Returns: object

get_rsi_analysisC

Get RSI analysis with overbought/oversold signals.

Inputs: ticker (required), period, days. Returns: object

get_screening_changesA

Get recent screening changes (symbol entries and exits). Optionally filter by screen_name. Returns up to limit changes, ordered newest-first.

Inputs: screen_name, limit. Returns: object

get_screening_historyB

Get screening run history for a specific symbol — showing each run in which the symbol appeared. Optionally filter by screen_name.

Inputs: symbol (required), screen_name. Returns: object

get_screening_pipeline_statusA

Return overall status of the screening pipeline — latest run per screen, result counts, and any configured scheduled jobs.

Inputs: no named parameters. Returns: object

get_status_dashboardB

Get comprehensive status dashboard data.

Returns aggregated health status, performance metrics, alerts, and historical trends for the entire backtesting system.

Returns: Dictionary containing complete dashboard information

Inputs: no named parameters. Returns: object

get_stock_infoC

Get fundamental data: market cap, P/E ratio, sector, industry, and more.

Inputs: ticker (required). Returns: object

get_strategy_comparisonA

Compare all strategies ranked by expectancy (highest first). Shows win/loss counts, total PnL, and key metrics for each strategy tag.

Inputs: no named parameters. Returns: object

get_strategy_helpB

Get detailed help for a specific strategy.

Inputs: strategy_type (required). Returns: object

get_strategy_performanceA

Return aggregated performance metrics for a strategy tag: win/loss count, total PnL, average win/loss, expectancy, and profit factor. Metrics are based on all closed trades tagged with this strategy.

Inputs: strategy_tag (required). Returns: object

get_supply_demand_breakoutsC

Screen for accumulation/breakout patterns in S&P 500.

Inputs: limit, filter_moving_averages. Returns: object

get_support_resistanceB

Get key support and resistance price levels.

Inputs: ticker (required), days. Returns: object

get_system_healthB

Get comprehensive system health status.

Returns detailed information about all system components including:

  • Overall health status

  • Component-by-component status

  • Resource utilization

  • Circuit breaker states

  • Performance metrics

Returns: Dictionary containing complete system health information

Inputs: no named parameters. Returns: object

get_tool_registry_statusA

Get tool registry status including rate limits and available tool categories.

Returns current rate limit usage and configuration for every tool category. Useful for monitoring tool availability and diagnosing rate-limit issues.

Returns: Dictionary with rate_limits (current usage) and tool_categories (config).

Inputs: no named parameters. Returns: object

get_upcoming_catalystsA

List upcoming catalyst events (earnings, ex-dividend, FDA decisions, etc.) within a given number of days from today. Optionally filter to a specific list of ticker symbols.

Inputs: symbols, days_ahead. Returns: object

get_user_portfolio_summaryC

Get basic portfolio summary and stock analysis capabilities.

Returns available features and sample stock data.

Inputs: no named parameters. Returns: object

get_watchlistC

Get sample watchlist with real-time stock data.

Provides stock data for popular tickers to demonstrate functionality.

Inputs: limit. Returns: object

journal_add_tradeA

Add an open trade to the journal. Record the symbol, side (long/short), entry price, and number of shares. Optionally include a rationale, strategy tags, and notes. Entry date defaults to now.

Inputs: symbol (required), side (required), entry_price (required), shares (required), +3 more. Returns: object

journal_close_tradeA

Close an existing open trade by entry ID. Provide the exit price; exit date defaults to now. PnL is automatically computed (long: exit-entry, short: entry-exit). Strategy performance metrics are recomputed for all tags on this trade.

Inputs: entry_id (required), exit_price (required), notes. Returns: object

journal_list_tradesA

List trades from the journal. Optionally filter by symbol, status (open/closed), or strategy tag. Returns up to limit trades (default 50), newest first.

Inputs: symbol, status, strategy_tag, limit. Returns: object

journal_trade_reviewA

Return full details for a trade entry by ID, including all computed metrics. Shows entry/exit prices, PnL, tags, rationale, and notes.

Inputs: entry_id (required). Returns: object

list_all_strategiesA

List all available backtesting strategies with their parameters.

Returns detailed information about each strategy including:

  • Strategy name and description

  • Required and optional parameters

  • Default parameter values

  • Example usage

Inputs: no named parameters. Returns: result

list_signalsA

List all configured signals, optionally filtering to active-only.

Inputs: active_only. Returns: object

list_strategiesA

List all available VectorBT strategies with descriptions.

Returns: Dictionary of available strategies and their information

Inputs: no named parameters. Returns: object

monte_carlo_simulationC

Run Monte Carlo simulation on backtest results.

Inputs: symbol (required), strategy, start_date, end_date, +4 more. Returns: object

optimize_strategyB

Optimize strategy parameters using VectorBT grid search.

Inputs: symbol (required), strategy, start_date, end_date, +3 more. Returns: object

parse_strategyA

Parse natural language strategy description into VectorBT parameters.

Inputs: description (required). Returns: object

performance_analyze_database_index_usageA

Analyze database index usage and provide optimization recommendations.

This tool examines database index usage statistics, identifies missing indexes, analyzes table scan patterns, and provides specific recommendations for database performance optimization. Use this for database tuning.

Returns: Database index analysis and optimization recommendations

Inputs: no named parameters. Returns: Response model for performance metrics.

performance_clear_system_cachesA

Clear specific performance caches for maintenance or testing.

This tool allows selective clearing of different cache types:

  • stock_data: Stock price and company information caches

  • screening: Maverick and trending stock screening caches

  • market_data: High volume and market analysis caches

  • all: Clear all performance caches

Use this for cache maintenance, testing, or when stale data is suspected.

Inputs: request (required). Returns: Response model for performance metrics.

performance_get_cache_performance_statusA

Get cache performance metrics and optimization suggestions.

This tool provides cache hit/miss ratios, operation latencies, Redis memory usage, and performance test results. Use this to optimize caching strategies and identify cache bottlenecks.

Returns: Cache performance metrics and test results

Inputs: no named parameters. Returns: Response model for performance metrics.

performance_get_database_performance_statusA

Get database query performance metrics and connection pool status.

This tool provides database query statistics, slow query detection, connection pool metrics, and database health tests. Use this to identify database performance bottlenecks and optimization opportunities.

Returns: Database performance metrics and query statistics

Inputs: no named parameters. Returns: Response model for performance metrics.

performance_get_redis_health_statusA

Get Redis connection pool health and performance metrics.

This tool provides detailed information about Redis connectivity, connection pool status, operation latency, and basic health tests. Use this when diagnosing Redis-related performance issues.

Returns: Redis health status and connection metrics

Inputs: no named parameters. Returns: Response model for performance metrics.

performance_get_system_performance_healthA

Get comprehensive system performance health report.

This tool provides an overall health assessment of the MaverickMCP system, including Redis connectivity, cache performance, database query metrics, and index usage analysis. Use this for general system health monitoring.

Inputs: request (required). Returns: Response model for comprehensive performance report.

performance_optimize_cache_configurationA

Analyze cache usage patterns and recommend optimal configuration.

This tool analyzes current cache hit rates, memory usage, and access patterns to recommend optimal TTL values, cache sizes, and configuration settings for maximum performance. Use this for cache tuning.

Returns: Cache optimization analysis and recommended settings

Inputs: no named parameters. Returns: Response model for performance metrics.

portfolio_add_positionB

Add a stock position to your portfolio.

This tool adds a new position or increases an existing position in your portfolio. If the ticker already exists, it will average the cost basis automatically.

Inputs: ticker (required), shares (required), purchase_price (required), purchase_date, +3 more. Returns: object

portfolio_clear_portfolioA

Clear all positions from your portfolio.

CAUTION: This removes all positions from the specified portfolio. This action cannot be undone.

Inputs: user_id, portfolio_name, confirm. Returns: object

portfolio_compare_tickersA

Compare multiple tickers using technical and fundamental metrics.

This tool provides side-by-side comparison of stocks including:

  • Price performance

  • Technical indicators (RSI, trend strength)

  • Volume characteristics

  • Momentum strength ratings

  • Risk metrics

Portfolio Integration: If no tickers are provided, automatically compares all positions in your portfolio, making it easy to see which holdings are performing best.

Inputs: tickers, days, user_id, portfolio_name. Returns: object

portfolio_correlation_analysisA

Analyze correlation between all portfolio holdings.

Auto-detects your portfolio positions. No need to specify tickers.

Inputs: days. Returns: object

portfolio_get_my_portfolioB

Get your complete portfolio with all positions and performance metrics.

This tool retrieves your entire portfolio including:

  • All stock positions with cost basis

  • Current market values (if prices available)

  • Profit/loss for each position

  • Portfolio-wide performance metrics

Inputs: user_id, portfolio_name, include_current_prices. Returns: object

portfolio_portfolio_correlation_analysisA

Analyze correlation between multiple securities.

DISCLAIMER: This correlation analysis is for educational purposes only. Past correlations do not guarantee future relationships between securities. Always diversify appropriately and consult with financial professionals.

This tool calculates the correlation matrix for a portfolio of stocks, helping to identify:

  • Highly correlated positions (diversification issues)

  • Negative correlations (natural hedges)

  • Overall portfolio correlation metrics

Portfolio Integration: If no tickers are provided, automatically analyzes correlation between all positions in your portfolio, helping you understand diversification and identify concentration risk.

Inputs: tickers, days, user_id, portfolio_name. Returns: object

portfolio_remove_positionA

Remove shares from a position in your portfolio.

This tool removes some or all shares of a stock from your portfolio. If no share count is specified, the entire position is removed.

Inputs: ticker (required), shares, user_id, portfolio_name. Returns: object

portfolio_risk_adjusted_analysisB

Perform risk-adjusted stock analysis with position sizing.

DISCLAIMER: This analysis is for educational purposes only and does not constitute investment advice. All investments carry risk of loss. Always consult with qualified financial professionals before making investment decisions.

This tool analyzes a stock with risk parameters tailored to different investment styles. It provides:

  • Position sizing recommendations based on ATR

  • Stop loss suggestions

  • Entry points with scaling

  • Risk/reward ratio calculations

  • Confidence score based on technicals

Portfolio Integration: If you already own this stock, the analysis includes:

  • Current position details (shares, cost basis, unrealized P&L)

  • Position sizing relative to existing holdings

  • Recommendations for averaging up/down

The risk_level parameter (0-100) adjusts the analysis from conservative (low) to aggressive (high).

Inputs: ticker (required), risk_level, user_id, portfolio_name. Returns: object

remove_portfolio_positionB

Remove or reduce a portfolio position.

Inputs: ticker (required), shares. Returns: object

research_analyze_market_sentimentB

Analyze market sentiment for a specific topic or sector.

Features:

  • Real-time sentiment extraction

  • News and social media analysis

  • Investor opinion aggregation

  • Trend identification

Inputs: topic (required), timeframe, persona. Returns: object

research_company_comprehensiveB

Perform comprehensive research on a specific company.

Features:

  • Financial metrics analysis

  • Market sentiment assessment

  • Competitive positioning

  • Investment recommendations

Inputs: symbol (required), include_competitive_analysis, persona. Returns: object

research_comprehensive_researchB

Perform comprehensive research on any financial topic using web search and AI analysis.

Enhanced features:

  • Generous timeout (basic: 120s, standard: 240s, comprehensive: 360s, exhaustive: 600s)

  • Intelligent source optimization

  • Parallel LLM processing

  • Progressive token budgeting

  • Partial results on timeout

Inputs: query (required), persona, research_scope, max_sources, +1 more. Returns: object

reset_circuit_breakerC

Reset a specific circuit breaker.

Inputs: breaker_name (required). Returns: object

risk_adjusted_analysisA

ATR-based position sizing and risk analysis with portfolio context.

Shows existing portfolio position if you hold this stock.

Inputs: ticker (required), risk_level. Returns: object

run_backtestC

Run a VectorBT backtest with specified strategy and parameters.

Inputs: symbol (required), strategy, start_date, end_date, +12 more. Returns: object

run_health_diagnosticsA

Run comprehensive health diagnostics.

Performs a complete system health check including all components, circuit breakers, resource usage, and generates a diagnostic report with recommendations.

Returns: Dictionary containing diagnostic results and recommendations

Inputs: no named parameters. Returns: object

run_ml_strategy_backtestC

Run backtest using ML-enhanced strategies.

Inputs: symbol (required), strategy_type, start_date, end_date, +7 more. Returns: object

schedule_screeningA

Register scheduling intent for a named screen. Records the screen name and interval in the database for future integration with the scheduler. Actual periodic execution is wired during the integration pass.

Inputs: screen_name (required), interval_minutes. Returns: object

screening_get_all_screening_recommendationsA

Get comprehensive screening results from all strategies.

This tool returns the top stocks from each screening strategy:

  • Maverick Bullish: High momentum growth stocks

  • Maverick Bearish: Weak stocks for short opportunities

  • Supply/Demand Breakouts: Stocks breaking out from accumulation phases

Returns: Dictionary containing all screening results organized by strategy

Inputs: no named parameters. Returns: object

screening_get_maverick_bear_stocksA

Get top Maverick Bear stocks from the screening results.

DISCLAIMER: Bearish screening results are for educational purposes only. This is not advice to sell short or make bearish trades. Short selling involves unlimited risk potential. Always consult financial professionals before trading.

The Maverick Bear screening identifies stocks with:

  • Weak momentum strength

  • Bearish technical patterns

  • Distribution characteristics

  • High bear scores

Inputs: limit. Returns: object

screening_get_maverick_stocksB

Get top Maverick stocks from the screening results.

DISCLAIMER: Stock screening results are for educational and research purposes only. This is not investment advice. Past performance does not guarantee future results. Always conduct thorough research and consult financial professionals before investing.

The Maverick screening strategy identifies stocks with:

  • High momentum strength

  • Technical patterns (Cup & Handle, consolidation, etc.)

  • Momentum characteristics

  • Strong combined scores

Inputs: limit. Returns: object

screening_get_screening_by_criteriaB

Get stocks filtered by specific screening criteria.

This tool allows custom filtering across all screening results based on:

  • Momentum score rating

  • Volume requirements

  • Price constraints

  • Sector preferences

Inputs: min_momentum_score, min_volume, max_price, sector, +1 more. Returns: object

screening_get_supply_demand_breakoutsA

Get stocks showing supply/demand breakout patterns from accumulation.

This screening identifies stocks in the demand expansion phase with:

  • Price above all major moving averages (demand zone)

  • Moving averages in proper alignment indicating accumulation (50 > 150 > 200)

  • Strong momentum strength showing institutional interest

  • Market structure indicating supply absorption and demand dominance

Inputs: limit, filter_moving_averages. Returns: object

technical_get_full_technical_analysisB

Get comprehensive technical analysis for a given ticker with enhanced logging and timeout handling.

This enhanced version provides:

  • Step-by-step logging for debugging

  • 25-second timeout to prevent hangs

  • Comprehensive error handling

  • Guaranteed JSON-RPC responses

Inputs: ticker (required), days.

technical_get_macd_analysisC

Get MACD analysis for a given ticker.

Inputs: ticker (required), fast_period, slow_period, signal_period, +1 more. Returns: object

technical_get_rsi_analysisC

Get RSI analysis for a given ticker.

Inputs: ticker (required), period, days. Returns: object

technical_get_stock_chart_analysisC

Generate a comprehensive technical analysis chart with enhanced error handling.

This enhanced version provides:

  • 15-second timeout for chart generation

  • Progressive chart sizing for Claude Desktop compatibility

  • Detailed logging for debugging

  • Graceful fallback on errors

Inputs: ticker (required).

technical_get_support_resistanceC

Get support and resistance levels for a given ticker.

Inputs: ticker (required), days. Returns: object

train_ml_predictorC

Train an ML predictor model for trading signals.

Inputs: symbol (required), start_date, end_date, model_type, +5 more. Returns: object

update_signalB

Update an existing signal's label, condition, interval, or active status.

Inputs: signal_id (required), label, condition, interval_seconds, +1 more. Returns: object

walk_forward_analysisB

Perform walk-forward analysis to test strategy robustness.

Inputs: symbol (required), strategy, start_date, end_date, +2 more. Returns: object

watchlist_addB

Add a ticker symbol to an existing watchlist. Optional notes can capture the thesis or context for watching the symbol.

Inputs: watchlist_id (required), symbol (required), notes. Returns: object

watchlist_briefA

Generate a scored intelligence brief for every symbol on a watchlist. Each entry includes: active signal count, upcoming catalyst flag (within 30 days), days on watchlist, and notes. Results are sorted by active signals descending.

Inputs: watchlist_id (required). Returns: object

watchlist_createA

Create a new named watchlist for tracking ticker symbols. The name must be unique. An optional description can be provided.

Inputs: name (required), description. Returns: object

watchlist_removeC

Remove a ticker symbol from a watchlist.

Inputs: watchlist_id (required), symbol (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 119 tools

    Disambiguation1/5

    Numerous tools share identical or near-identical purposes (e.g., get_maverick_stocks vs screening_get_maverick_stocks, get_my_portfolio vs portfolio_get_my_portfolio, fetch_stock_data vs data_fetch_stock_data). An agent cannot reliably distinguish between duplicates, leading to high misselection risk.

    Naming Consistency2/5

    Naming conventions are mixed: some tools use domain prefixes (technical_, screening_, portfolio_), others do not (get_rsi_analysis, run_backtest). Even within the same domain, prefixes vary (get_system_health vs performance_get_system_performance_health). Verbs and noun structures are inconsistent.

    Tool Count1/5

    119 tools is far beyond what is needed for a stock analysis server. The excessive count is inflated by many redundant or overlapping tools, making the surface bloated and unwieldy rather than well-scoped.

    Completeness3/5

    Despite numerous duplicates, the server covers many core domains (screening, portfolio management, backtesting, technical analysis, watchlists, journaling, risk). However, some obvious CRUD operations are missing (e.g., delete watchlist, update journal trade), and the massive duplication suggests incoherent design rather than complete coverage.

    Maintenance

    ActivityActive
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides real-time stock market data for Claude Desktop and MCP-compatible clients, enabling natural language queries for quotes, historical prices, company profiles, financial statements, analyst ratings, comparisons, news, options, holdings, dividends, estimates, symbol search, and market status.
      18
      961 npm
      26
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.
      10
      75
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for stock prices, historical data, FX rates, and ticker search, powered by yfinance with no API key required. Designed for Claude Desktop.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive stock market data and technical analysis tools via the MCP protocol, enabling real-time quotes, historical data, and professional indicators like RSI and MACD for Claude Desktop and other clients.
      5
      Apache 2.0