Skip to main content
Generaldvcrn

jquants-mcp

Access JPX stock market data via J-Quants API — search stocks, get daily OHLCV prices, financial summaries (revenue, profit, EPS, ROE), and earnings calendar for Tokyo Stock Exchange (TSE) listed companies. Japan stock price data.

Stars
15
Source
dvcrn/openclaw-skills-marketplace
Updated
2026-05-29
Slug
dvcrn--openclaw-skills-marketplace--jquants-mcp
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/dvcrn/openclaw-skills-marketplace/HEAD/plugins/ajtgjmdjp--jquants-mcp/skills/jquants-mcp/SKILL.md -o .claude/skills/jquants-mcp.md

Drops the SKILL.md into .claude/skills/jquants-mcp.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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

# By stock code
jquants-mcp search 7203

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

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

Get stock prices

# 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

jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output

Get earnings calendar

# 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

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.