jquants-mcp

# J-Quants: JPX Stock Market Data

Access Tokyo Stock Exchange (TSE) listed stock data via the official J-Quants API. Search stocks, get daily OHLCV prices, financial summaries, and earnings announcement calendar.

**Important: This tool is for personal use only.** Data redistribution is prohibited by J-Quants Terms of Service. https://jpx-jquants.com/termsofservice

## Use Cases

- Search for TSE-listed stocks by code or company name
- Get daily OHLCV price data for any stock
- Retrieve financial summaries (revenue, profit, EPS, ROE)
- Check upcoming earnings announcement dates
- Compare financial metrics across companies

## Commands

### Search stocks
```bash
# By stock code
jquants-mcp search 7203

# By company name (Japanese)
jquants-mcp search トヨタ

# JSON output
jquants-mcp search ソニー --json-output
```

### Get stock prices
```bash
# Default: last 30 days
jquants-mcp price 7203

# With date range
jquants-mcp price 7203 --start-date 2024-01-01 --end-date 2024-12-31

# JSON output
jquants-mcp price 7203 --json-output
```

### Get financial data
```bash
jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output
```

### Get earnings calendar
```bash
# Default: next 30 days
jquants-mcp calendar

# With date range
jquants-mcp calendar --start-date 2024-04-01 --end-date 2024-06-30
```

### Test connectivity
```bash
jquants-mcp test
```

## Workflow

1. `jquants-mcp search <company>` → find stock code
2. `jquants-mcp price <code>` → get price history
3. `jquants-mcp financials <code>` → get financial data
4. `jquants-mcp calendar` → check earnings dates

## Setup

- Requires `JQUANTS_MAIL_ADDRESS` and `JQUANTS_PASSWORD` environment variables
- Free account registration: https://jpx-jquants.com/
- Python package: `pip install jquants-mcp` or `uv tool install jquants-mcp`

## Terms of Service

By using this tool, you agree to the J-Quants Terms of Service.
Data is for personal use only — redistribution is prohibited.