An MCP (Model Context Protocol) server that provides Indonesian stock (IDX) analysis tools for Claude Code. Ask Claude Code questions about stocks and get real-time analysis with buy/sell recommendations.

Features

• Real-time Stock Data: Current prices, historical data for all IDX stocks
• Technical Analysis: RSI, MACD, Moving Averages, Bollinger Bands
• Fundamental Analysis: P/E, P/B, ROE, EPS, Dividend Yield, and more
• Market Movers: Track top gainers and losers from IDX30
• Smart Logging: All recommendations saved to logs/ for tracking
• Seamless Integration: Works directly in Claude Code - just ask questions!

Quick Start

1. Install Dependencies

cd /Users/antariksa/Project/stock_ai_agent
pip install -r requirements.txt

2. Configure Claude Code

Add to your MCP settings file (~/.config/claude-code/mcp_settings.json or Claude Desktop config):

{
  "mcpServers": {
    "idx-stock-analysis": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "/Users/antariksa/Project/stock_ai_agent"
    }
  }
}

Important: Update the cwd path to match your actual project location!

3. Restart Claude Code

Restart Claude Code to load the MCP server.

4. Start Analyzing!

Ask Claude Code questions like:

• "What's the current price of BBCA?"
• "Analyze BBRI technical indicators"
• "Should I buy TLKM right now?"
• "Show me today's top market movers"
• "Compare BBCA and BMRI fundamentals"

MCP Tools Available

The server provides 7 tools that Claude Code can use:

1. get_stock_price - Current price and basic info
2. get_historical_data - Historical OHLCV data
3. get_technical_indicators - RSI, MACD, MA, Bollinger Bands
4. get_fundamentals - P/E, P/B, ROE, margins, etc.
5. get_market_movers - Top gainers/losers from IDX30
6. log_recommendation - Save buy/sell decisions
7. get_recommendation_history - Review past recommendations

Market Hours

Indonesian Stock Exchange (IDX) - Western Indonesia Time (WIB):

• Pre-open: 08:45-09:00
• Session 1: 09:00-12:00
• Break: 12:00-13:30
• Session 2: 13:30-16:00

Best used during trading hours for real-time decisions.

Documentation

• QUICKSTART.md - Get started in 5 minutes! ⚡
• SETUP.md - Detailed installation and troubleshooting
• EXAMPLES.md - Example conversations and use cases
• requirements.txt - Python dependencies

Project Structure

stock_ai_agent/
├── src/
│   └── mcp_server.py          # Main MCP server with 7 stock analysis tools
├── logs/                       # Auto-generated recommendation logs
│   └── recommendations_*.jsonl
├── QUICKSTART.md               # 5-minute setup guide
├── SETUP.md                    # Detailed setup instructions
├── EXAMPLES.md                 # Usage examples and sample queries
├── requirements.txt            # Python dependencies
├── pyproject.toml              # Project configuration
├── test_server.py              # Test suite
└── setup_env.sh                # Automated environment setup

How It Works

1. MCP Server (src/mcp_server.py): Exposes 7 tools via Model Context Protocol
2. Claude Code: Automatically calls these tools when you ask stock questions
3. Data Source: Yahoo Finance (yfinance) - free, real-time Indonesian stock data
4. Analysis: Technical indicators (ta library) + fundamental data
5. Logging: All recommendations saved to logs/ directory

Popular Indonesian Stocks

Sector	Stocks
Banking	BBCA, BBRI, BMRI, BBNI
Telecom	TLKM, EXCL
Consumer	UNVR, INDF, ICBP
Auto	ASII, UNTR
Mining	ADRO, PTBA, ANTM
Cement	SMGR, INTP

Contributing

Found a bug or want to add features?

1. Fork the repository
2. Make your changes
3. Submit a pull request

Ideas for enhancements:

• Add more Indonesian stock data sources (Stockbit API, IDX API)
• Implement portfolio tracking and P&L calculation
• Add news sentiment analysis
• Create automated hourly alerts during market hours
• Backtesting framework for recommendations

License

MIT License

stock_mcp