MaverickMCP

v1.0.0Finance & Fintechstable

A personal stock analysis MCP server that provides professional-grade financial data analysis, technical indicators, and portfolio optimization tools directly to your Claude Desktop interface. Pre-seeded with all 520 S\\&P 500 stocks and comprehensive

anthropicartificial-intelligenceclaudeequitiesfastmcp
Share:
560
Stars
0
Downloads
0
Weekly
0/5

What is MaverickMCP?

MaverickMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to personal stock analysis mcp server that provides professional-grade financial data analysis, technical indicators, and portfolio optimization tools directly to your claude desktop interface. pre-seede...

A personal stock analysis MCP server that provides professional-grade financial data analysis, technical indicators, and portfolio optimization tools directly to your Claude Desktop interface. Pre-seeded with all 520 S\\&P 500 stocks and comprehensive

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A personal stock analysis MCP server that provides professio

Use Cases

Professional stock analysis MCP
S&P 500 technical indicators
Portfolio optimization tools
wshobson

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx maverickmcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MaverickMCP

MaverickMCP is a personal stock analysis MCP server that brings professional-grade financial intelligence to Claude Desktop, exposing 39+ tools for stock data retrieval, technical indicator calculation, portfolio management, backtesting, sector analysis, and multi-agent research. It comes pre-seeded with all 520 S&P 500 stocks and uses the Tiingo API for market data, VectorBT for backtesting, and optional integrations with OpenRouter (400+ AI models), Exa web search, FRED economic data, and Reddit/X sentiment via Adanos. Individual investors and quant enthusiasts use it to conduct institutional-quality analysis — running momentum backtests, screening for opportunities, and managing portfolios — entirely through natural language in Claude.

Prerequisites

  • Python 3.12+ (required by MaverickMCP)
  • uv package manager (install from docs.astral.sh/uv)
  • TA-Lib system library (brew install ta-lib on macOS, or via apt/conda)
  • Tiingo API key — free tier at tiingo.com provides stock data
  • Claude Desktop or another MCP-compatible client
1

Clone the repository

Download the MaverickMCP source code from GitHub.

git clone https://github.com/wshobson/maverick-mcp
cd maverick-mcp
2

Install TA-Lib system dependency

TA-Lib requires a native C library before the Python binding can be installed. Install it with your system package manager.

# macOS:
brew install ta-lib

# Ubuntu/Debian:
sudo apt-get install libta-lib-dev
3

Copy the environment template and set your API keys

Copy .env.example to .env and fill in your API keys. TIINGO_API_KEY is required; the others unlock additional features.

cp .env.example .env
# Edit .env and set:
# TIINGO_API_KEY=your-tiingo-key
# OPENROUTER_API_KEY=your-openrouter-key  (optional, for 400+ models)
# EXA_API_KEY=your-exa-key                (optional, for web search)
# FRED_API_KEY=your-fred-key              (optional, for economic data)
4

Install Python dependencies with uv

Use uv to sync the project's dependencies into an isolated virtual environment.

uv sync
5

Configure Claude Desktop

Add MaverickMCP to your Claude Desktop configuration, pointing to the cloned project directory. The server runs via STDIO transport.

{
  "mcpServers": {
    "maverick-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "maverick_mcp.api.server", "--transport", "stdio"],
      "cwd": "/absolute/path/to/maverick-mcp"
    }
  }
}
6

Restart Claude Desktop and verify

Fully quit and reopen Claude Desktop. On first run the server loads S&P 500 data. Ask Claude to list available stocks or run a quick analysis to confirm the tools are active.

MaverickMCP Examples

Client configuration

Claude Desktop JSON configuration for MaverickMCP using uv and STDIO transport.

{
  "mcpServers": {
    "maverick-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "maverick_mcp.api.server", "--transport", "stdio"],
      "cwd": "/absolute/path/to/maverick-mcp"
    }
  }
}

Prompts to try

Sample Claude prompts that exercise MaverickMCP's stock analysis, backtesting, and portfolio tools.

- "Run a 6-month momentum backtest on AAPL and show me the Sharpe ratio and max drawdown"
- "Get RSI and MACD for NVDA and tell me if there's a bullish signal"
- "Research the AI semiconductor sector and identify the top 3 opportunities"
- "Analyze correlation in my portfolio: AAPL 100 shares at $150, MSFT 50 shares at $300, GOOGL 20 shares at $140"
- "Compare MSFT, GOOGL, and AMZN cloud computing revenue growth over the past 4 quarters"
- "Screen the S&P 500 for stocks with RSI below 30 and positive earnings growth"

Troubleshooting MaverickMCP

Installation fails with 'TA-Lib not found' or similar build errors

The TA-Lib Python package requires the native C library to be installed first. On macOS run 'brew install ta-lib' before 'uv sync'. On Ubuntu/Debian run 'sudo apt-get install libta-lib-dev'. Then retry 'uv sync'.

Stock data tools return empty results or 'authentication failed'

TIINGO_API_KEY is required for all market data. Register for a free account at tiingo.com, copy your API key, and set it in .env as TIINGO_API_KEY=your-key. Make sure the .env file is in the maverick-mcp project root.

Claude Desktop on Windows fails to launch the server

There is a known issue with 'cwd' handling on Windows when using uv. Wrap the command: set 'command' to 'cmd.exe' and 'args' to ['/c', 'cd /d C:\path\to\maverick-mcp && uv run python -m maverick_mcp.api.server --transport stdio'].

Frequently Asked Questions about MaverickMCP

What is MaverickMCP?

MaverickMCP is a Model Context Protocol (MCP) server that personal stock analysis mcp server that provides professional-grade financial data analysis, technical indicators, and portfolio optimization tools directly to your claude desktop interface. pre-seeded with all 520 s\\&p 500 stocks and comprehensive It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MaverickMCP?

Follow the installation instructions on the MaverickMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MaverickMCP?

MaverickMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MaverickMCP free to use?

Yes, MaverickMCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "maverickmcp": { "command": "npx", "args": ["-y", "maverickmcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MaverickMCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides