MaverickMCP
MaverickMCP is a local stock-market MCP server for market data, technical analysis, screening, portfolio tracking, backtesting, research, and AI-agent workflows.
Fetch quotes, price history, fundamentals, market overview, chart links, news/Adanos sentiment, cached data, and economic calendar.
Run technical analysis including RSI, MACD, support/resistance, full technical analysis, and chart analysis.
Screen stocks for bullish, bearish, supply/demand, and custom criteria; review screening history, changes, scheduling, and pipeline status.
Track portfolios: add/remove positions, calculate P&L, compare tickers, analyze correlations, check risk, size positions, and get risk dashboards/alerts.
Manage watchlists and trade journals: create/add/remove watchlist symbols, brief watchlists, log/close/review trades, and compare strategy performance.
Backtest strategies with VectorBT: single and portfolio backtests, optimization, walk-forward, Monte Carlo, strategy comparison, ML strategies, predictor training, regime analysis, ensembles, and charts.
Create, update, list, delete, check, and backtest persistent price/indicator alert signals.
Detect current and historical market regimes.
Use LangGraph AI agents for market analysis, persona comparison, orchestrated multi-agent analysis, streaming analysis, and deep financial research.
Monitor system performance and health: Redis, cache, database, indexes, circuit breakers, resource usage, diagnostics, tool registry status, and decision logs.
Provides optional integration for AI-powered financial analysis features using OpenAI's language models
Supports PostgreSQL as a backend database option for storing financial data and analysis results
Uses Redis for intelligent caching of stock data and analysis results to improve performance
Uses SQLite as the default database backend for storing financial data and S&P 500 stock information
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MaverickMCP show me technical indicators for Apple over the last month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MaverickMCP: stock market MCP server for local analysis
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 .envSecond, add optional packages if you need backtesting or research.
uv sync --extra backtesting --extra researchThird, 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 stdioThe 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 stdioConnect 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:localThe 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 |
| OHLCV price history for a ticker, stored locally and refreshed on access. |
| Price history for multiple tickers at once. |
| A single quote, cached briefly. Returns an error when Yahoo has no price for the ticker (delisted or unknown). |
| Valuation, financials, and trading stats. |
| Indices, sector performance, top movers, and volatility. |
| Static external chart links for a ticker. |
| Clear cached quotes (mutates cache state). |
Technical analysis
Tool | Description |
| RSI reading and signal label. |
| MACD reading, signal label, and crossover state. |
| Observed price extrema over the requested history. |
| Trend, outlook, and technical indicators. |
Stock screening
Tool | Description |
| Top Maverick bullish-momentum results, latest snapshot. |
| Top bearish setup results, latest snapshot. |
| Top supply/demand breakout results, latest snapshot. |
| Latest snapshot across all three screens. |
| Bullish results filtered by arbitrary criteria. |
| 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 |
| Add/average into a position (mutates). |
| Portfolio snapshot with P&L using current available quotes. |
| Remove shares from a position (mutates). |
| Remove every position; requires |
| ATR-based position sizing/stop/target. |
| Ticker comparison, using your portfolio when tickers are omitted. |
| Correlation matrix and diversification metrics. |
| Total value, sector exposure, and risk metrics. |
| Pre-trade risk check for a hypothetical trade. |
| Position size scaled by detected market regime. |
| Current sector/position/portfolio risk alerts. |
| List watchlist IDs and names. |
| Create a named watchlist (mutates). |
| Add a ticker to a watchlist (mutates). |
| Remove a ticker from a watchlist (mutates). |
| Quotes and analysis for the symbols on a watchlist. |
| Log a new open trade; optional ISO |
| Close an open trade; profit or loss calculated automatically (mutates). |
| List journal trades, optionally filtered. |
| Full detail for a single journal trade. |
| 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 |
| Run a single-strategy backtest: metrics, trades, analysis. |
| Grid-search a strategy's parameters. |
| Rolling optimize/test windows to gauge robustness. |
| Bootstrap-resample trades for a return/drawdown distribution. |
| Backtest multiple strategies on the same symbol and rank them. |
| List every rule-based strategy template with default parameters. |
| Backtest one strategy across multiple symbols. |
| Parse a natural-language description into a strategy + parameters (BYOK LLM). |
| Backtest a machine learning strategy (predictor, adaptive, ensemble, or regime). |
| Train a random-forest ML predictor for trading signals. |
| Detect bear/sideways/bull regimes for a symbol. |
| 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 |
| Web research on a financial topic, with source citations. |
| Company research, with source citations. |
| 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 |
| Select SQLite or PostgreSQL. Local processes default to |
| Enable Redis caching. Otherwise the server uses memory and SQLite. |
| Configure the language model for research and natural-language strategy parsing. |
| Set a custom endpoint, required for |
| Optionally override the model's sampling temperature. Omit it to use the provider default. |
| Enable Exa web search for research. |
| Use |
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-checkmake 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 toolsadd_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_chart_linksA
Provide links to various financial charting websites.
This tool generates URLs to popular financial websites where detailed stock charts can be viewed, including:
TradingView (advanced charting)
Finviz (visual screener)
Yahoo Finance (comprehensive data)
StockCharts (technical analysis)
Inputs: ticker (required). 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
Scored across 119 tools
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 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.
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.
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
Related MCP Connectors
Production MCP server for US equity and options intelligence: real-time IV radar, Monte Carlo simulation, options pressure, strategy backtesting, AI prediction, pre-trade risk analysis, and automated stock research reports.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides 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.18961 npm26MIT
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for stock prices, historical data, FX rates, and ticker search, powered by yfinance with no API key required. Designed for Claude Desktop.1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides 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.5Apache 2.0