by wshobson
MaverickMCP - Personal Stock Analysis MCP Server
# Add to your Claude Code skills
git clone https://github.com/wshobson/maverick-mcpGuides for using mcp servers skills like maverick-mcp.
Last scanned: 5/14/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-14T06:46:26.488Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
MaverickMCP 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:
make dev command gets you running (or uv sync + make dev)uv 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: STDIO connection
Claude Desktop works best with direct STDIO for local use:
{
"mcpServers": {
"maverick-mcp": {
"command": "uv",
"args": [
"run",
"python",
"-m",
"maverick_mcp.api.server",
"--transport",
"stdio"
],
"cwd": "/path/to/maverick-mcp"
}
}
}
[!WARNING] Windows Claude Desktop Users Claude Desktop on Windows currently has a bug where it ignores the
"cwd"configuration parameter, which can cause the server to crash with aModuleNotFoundErrorwhen running viauv.To bypass this, wrap the command in
cmd.exeto force the directory change:"maverick-mcp": { "command": "cmd.exe", "args": [ "/c", "cd /d C:\\Path\\To\\maverick-mcp && uv run python -m maverick_mcp.api.server --transport stdio" ] }
Config File Location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAlways restart Claude Desktop after making configuration changes.
Alternative: Streamable HTTP with mcp-remote
Start the server:
make dev
Then configure a bridge:
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/mcp/"]
}
}
}
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: Streamable HTTP bridge:
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/mcp/"]
}
}
}
Option 2: Legacy direct SSE:
{
"mcpServers": {
"maverick-mcp": {
"url": "http://localhost:8003/sse/"
}
}
}
Config Location: Cursor → Settings → MCP Servers
HTTP transport:
claude mcp add --transport http maverick-mcp http://localhost:8003/mcp/
SSE transport (legacy/debug):
claude mcp add --transport sse maverick-mcp http://localhost:8003/sse/
STDIO transport:
claude mcp add maverick-mcp uv run python -m maverick_mcp.api.server --transport stdio
Option 1: Streamable HTTP bridge:
{
"mcpServers": {
"maverick-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8003/mcp/"]
}
}
}
Option 2: Legacy direct SSE:
{
"mcpServers": {
"maverick-mcp": {
"serverUrl": "http://localhost:8003/sse/"
}
}
}
Config Location: Windsurf → Settings → Advanced Settings → MCP Servers
The mcp-remote tool bridges clients that launch local STDIO commands to a
server that is already running over HTTP:
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/hot_reload.py # Auto-restart on file changes
# Server will be available at:
# - HTTP endpoint: http://localhost:8003/mcp/ (streamable