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!

Related MCP server: Baguskto Saham

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

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