Quick Start Guide

The fastest way to get StockBud working with your AI assistant.

TL;DR

# Clone
git clone https://github.com/neverpeak/mcp-server-stockbud.io
cd mcp-server-stockbud.io
 
# Setup
uv venv && uv pip install -r requirements.txt
cp env.v2.sample .env
# Edit .env with your ALPACA_API_KEY and ALPACA_SECRET_KEY
 
# Run
uv run python scripts/start/stockbud_main.py

Demo Mode

Don't have an Alpaca account yet? Run in demo mode:

STOCKBUD_DEMO_MODE=1 uv run python scripts/start/stockbud_main.py

This uses mock data so you can explore the features.

CLI Chat Interface

Test StockBud directly from the terminal:

uv run python clients/cli/chat_repl.py

Try these commands:

• portfolio - View your positions
• analyze AAPL - Analyze Apple stock
• market sentiment - Get market overview
• help - See all commands

What's Next?

Now that StockBud is running:

1. Connect to Claude Desktop - Add StockBud to your MCP config
2. Explore the API - See all available MCP tools
3. Customize - Configure alerts, strategies, and more