by wshobson
MaverickMCP - Personal Stock Analysis MCP Server
# Add to your Claude Code skills
git clone https://github.com/wshobson/maverick-mcpMaverickMCP is a personal-use FastMCP 2.0 server that provides professional-grade financial data analysis, technical indicators, and portfolio optimization tools directly to your Claude Desktop interface. Built for individual traders and investors, it offers comprehensive stock analysis capabilities without any authentication or billing complexity.
The server comes pre-seeded with all 520 S&P 500 stocks and provides advanced screening recommendations across multiple strategies. It runs locally with HTTP/SSE/STDIO transport options for seamless integration with Claude Desktop and other MCP clients.
MaverickMCP provides professional-grade financial analysis tools directly within your Claude Desktop interface. Perfect for individual traders and investors who want comprehensive stock analysis capabilities without the complexity of expensive platforms or commercial services.
Key Benefits:
No comments yet. Be the first to share your thoughts!
make devuv syncmake devuv for lightning-fast dependency managementTA-Lib is required for technical analysis calculations.
macOS and Linux (Homebrew):
brew install ta-lib
Windows (Multiple Options):
Option 1: Conda/Anaconda (Recommended - Easiest)
conda install -c conda-forge ta-lib
Option 2: Pre-compiled Wheels
TA_Lib-0.4.28-cp312-cp312-win_amd64.whl for Python 3.12 64-bit)pip install path/to/downloaded/TA_Lib-X.X.X-cpXXX-cpXXX-win_amd64.whl
Option 3: Alternative Pre-compiled Package
pip install TA-Lib-Precompiled
Option 4: Build from Source (Advanced) If other methods fail, you can build from source:
C:\ta-libpip install ta-libVerification: Test your installation:
python -c "import talib; print(talib.__version__)"
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Alternative: via pip
pip install uv
# Clone the repository
git clone https://github.com/wshobson/maverick-mcp.git
cd maverick-mcp
# Install dependencies and create virtual environment in one command
uv sync
# Copy environment template
cp .env.example .env
# Add your Tiingo API key (free at tiingo.com)
# Clone the repository
git clone https://github.com/wshobson/maverick-mcp.git
cd maverick-mcp
# Create virtual environment and install
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -e .
# Copy environment template
cp .env.example .env
# Add your Tiingo API key (free at tiingo.com)
# One command to start everything (includes S&P 500 data seeding on first run)
make dev
# The server is now running with:
# - HTTP endpoint: http://localhost:8003/mcp/
# - SSE endpoint: http://localhost:8003/sse/
# - 520 S&P 500 stocks pre-loaded with screening data
Recommended: SSE Connection (Stable and Reliable)
This configuration provides stable tool registration and prevents tools from disappearing:
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/sse/"]
}
}
}
Important: Note the trailing slash in
/sse/- this is REQUIRED to prevent redirect issues!
Config File Location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonWhy This Configuration Works Best:
Alternative: Direct STDIO Connection (Development Only)
{
"mcpServers": {
"maverick-mcp": {
"command": "uv",
"args": [
"run",
"python",
"-m",
"maverick_mcp.api.server",
"--transport",
"stdio"
],
"cwd": "/path/to/maverick-mcp"
}
}
}
Important: Always restart Claude Desktop after making configuration changes. The SSE configuration via mcp-remote has been tested and confirmed to provide stable, persistent tool access without connection drops.
That's it! MaverickMCP tools will now be available in your Claude Desktop interface.
Config Location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonOption 1: STDIO (via mcp-remote):
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/sse/"]
}
}
}
Option 2: Direct SSE:
{
"mcpServers": {
"maverick-mcp": {
"url": "http://localhost:8003/sse/"
}
}
}
Config Location: Cursor → Settings → MCP Servers
HTTP Transport (Recommended):
claude mcp add --transport http maverick-mcp http://localhost:8003/mcp/
SSE Transport (Alternative):
claude mcp add --transport sse maverick-mcp http://localhost:8003/sse/
STDIO Transport (Development):
claude mcp add maverick-mcp uv run python -m maverick_mcp.api.server --transport stdio
Option 1: STDIO (via mcp-remote):
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/mcp/"]
}
}
}
Option 2: Direct SSE:
{
"mcpServers": {
"maverick-mcp": {
"serverUrl": "http://localhost:8003/sse/"
}
}
}
Config Location: Windsurf → Settings → Advanced Settings → MCP Servers
The mcp-remote tool bridges the gap between STDIO-only clients (like Claude Desktop) and HTTP/SSE servers. Without it, these clients cannot connect to remote MCP servers:
MaverickMCP provides 39+ financial analysis tools organized into focused categories, including advanced AI-powered research agents:
# Start the server (one command!)
make dev
# Alternative startup methods
./scripts/start-backend.sh --dev # Script-based startup
./tools/fast_dev.sh # Ultra-fast startup (< 3 seconds)
uv run python tools