# Indonesian Stock Analysis MCP Server

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

```bash
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):

```json
{
  "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](QUICKSTART.md)** - Get started in 5 minutes! ⚡
- **[SETUP.md](SETUP.md)** - Detailed installation and troubleshooting
- **[EXAMPLES.md](EXAMPLES.md)** - Example conversations and use cases
- **[requirements.txt](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