MCP.Market

J-Quants MCP server

by shigechika·io.github.shigechika/jquants-mcp·v1.5.2·3 stars
No reviews yet

MCP server for retrieving Japanese stock market data via J-Quants API v2

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

3 stars910 downloads/wk

Reviews

Write one

Nobody has reviewed J-Quants MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

J-Quants MCP tools (55, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cache_clear

    Clear cached data.

  • cache_status

    Show database metadata: table row counts, file size, and detected plan.

  • compare_close_vs_vwap

    Compare a stock's close to its daily VWAP (買い圧力・売り圧力) for one code. All plans.

  • delete_api_keywrite action

    Delete your registered J-Quants API key (multi-user mode).

  • detect_52w_high_low

    Screen for 52-week rolling high/low breakouts (52週高値/安値 ブレイク). All plans.

  • detect_52w_high_low_range

    Scan 52-week high/low breakouts (52週高値/安値) across a date range. All plans.

  • detect_consecutive_dividend_increase

    Screen for stocks with consecutive annual dividend increases (連続増配). All plans.

  • detect_distribution_days

    Count TOPIX distribution days (機関投資家の売り) in a rolling window. All plans.

  • detect_follow_through_day

    Check whether a follow-through day (フォロースルーデイ) confirms a new uptrend. All plans.

  • detect_price_change

    Return the daily advance/decline summary for all listed equities (騰落集計). All plans.

  • detect_price_limit

    Find stocks that hit the daily price limit (ストップ高/安) on a trading day. All plans.

  • detect_volume_surge

    Identify stocks with abnormally high trading volume (出来高急増) on a given day. All plans.

  • detect_ytd_high_low

    Screen for year-to-date high/low records (年初来高値/安値 更新). All plans.

  • detect_ytd_high_low_range

    Scan year-to-date high/low records (年初来高値/安値) across a date range. All plans.

  • get_advance_decline_ratio

    Return the advance/decline ratio (騰落レシオ) over the last period trading days. All plans.

  • get_bulk_download_url

    Step 2 of bulk CSV download: get a signed URL for a specific file. Light+.

  • get_bulk_list

    Step 1 of bulk CSV download: list available files for a dataset (一括DL). Light+.

  • get_candlestick_data

    Return candlestick OHLCV + indicator data as JSON (ローソク足データJSON). All plans.

  • get_comparison_chart_data

    Return time-series data for a multi-stock comparison (複数銘柄比較データ). All plans.

  • get_derivatives_bars_daily_futures

    Daily futures OHLC bars (先物日足). Premium only.

  • get_derivatives_bars_daily_options

    Daily options OHLC bars with IV (オプション日足). Premium only.

  • get_derivatives_bars_daily_options_225

    Daily Nikkei 225 options OHLC bars (日経225オプション). Standard+.

  • get_dividend_yield_ranking

    High dividend yield stock ranking (高配当利回りランキング). All plans.

  • get_earnings_results_this_week

    Earnings results actually disclosed in a date window, grouped by day (今週の決算実績). All plans.

  • get_earnings_this_week

    Companies reporting earnings in a date window, grouped by day (今週の決算予定). All plans.

  • get_equities_bars_daily

    Per-stock or per-day OHLC bars (日足株価). All plans.

  • get_equities_bars_daily_am

    Today's morning session OHLC bars (前場株価). Premium only.

  • get_equities_bars_minute

    Per-stock 1-minute OHLC bars (分足株価). Light+ with tick add-on.

  • get_equities_earnings_calendar

    Find upcoming/past earnings announcement dates (決算発表日). Free / all plans.

  • get_equities_investor_types

    Weekly trading value by investor type (投資家別売買動向). Light+.

  • get_equities_master

    Listed stock master: company name, industry code, market segment (上場銘柄マスタ). Free.

  • get_fins_details

    Use only when individual BS/PL/CF line items are needed (Premium plan only).

  • get_fins_dividend

    Retrieve cash dividend data.

  • get_fins_summary

    Use this first for any financial metric query (EPS, BPS, 売上, 利益, 配当, 業績予想). All plans.

  • get_indices_bars_daily

    Retrieve daily index bars (OHLC).

  • get_indices_bars_daily_topix

    Retrieve daily TOPIX bars (OHLC) with Tier 1 cache.

  • get_market_briefing

    Daily market briefing: ADR, sector ranking, top movers, turnover, screener highlights (相場ブリーフィング).

  • get_markets_breakdown

    Retrieve market breakdown data (sell/buy by investor type per issue).

  • get_markets_calendar

    Retrieve market calendar (trading days and holidays).

  • get_markets_margin_alert

    Per-stock margin trading restriction status: 増担保規制・信用規制. Standard+ only.

  • get_markets_margin_interest

    Per-stock margin balance: 買残・売残・貸借倍率 (信用残). Standard+ only.

  • get_markets_short_ratio

    TSE 33-sector short selling ratio (業種別空売り比率). Standard+ only.

  • get_markets_short_sale_report

    Per-stock institutional short sale positions (大量空売り残高). Standard+ only.

  • get_sector_briefing

    Return sector-level median PER, PBR, ROE, and margin ratio (業種別ブリーフィング). All plans.

  • get_sector_performance

    Sector-level average price change ranking (業種別騰落率). All plans.

  • get_stock_briefing

    One-page briefing for a single stock: price, financials, valuation, and margin (株式ブリーフィング). All plans.

  • get_technical_indicators

    Compute technical indicators (SMA, Bollinger Bands, RSI) for a single stock (テクニカル指標). All plans.

  • get_top_movers

    Return top stocks by percentage price change on a given trading date.

  • get_top_turnover_value

    Return top stocks by turnover value (売買代金ランキング) on a given date. All plans.

  • get_top_volume

    Return top stocks by trading volume on a given date.

  • get_valuation_ranking

    Rank listed stocks by PER or PBR valuation multiple (バリュエーションランキング). All plans.

  • get_value_stock_screen

    Screen value stocks near their 52-week low with high forward dividend yield and a profit-increase forecast (年安・割安・高配当・好決算スクリーニング). All plans.

  • health_check

    Check server health, API key configuration, and cache readiness.

  • register_api_key

    Register or update your J-Quants API key (multi-user mode).

  • search_equities

    Search for listed stocks by company name (reverse lookup: 会社名 → コード).

Public scan report

scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it

no findings
  • Code scan58 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 6 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How J-Quants MCP compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 95% of 1,761 Finance servers
Tools
55
the typical Finance server has 8
Tools that change things
2%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 83% of 946 Finance servers
Downloads a week
910
more than 96% of 421 Finance servers with a package

What its tools let an agent do: 53 read · 1 create · 1 delete

Release history: 4 versions in the registry since 2026-08-22, latest 2026-10-26, typically one every 13 days.

Install J-Quants MCP in Claude Code, Cursor or VS Code

claude mcp add jquants-mcp -- uvx jquants-mcp
Add to Cursor

What the publisher says

From the J-Quants MCP repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.shigechika/jquants-mcp -->

jquants-mcp

English | 日本語

An MCP (Model Context Protocol) server that retrieves Japanese stock market data via J-Quants API v2.

User-facing documentation site: (also available in 日本語) — start there if you want a gentler 5-minute introduction. This README is the technical reference (config schema, all 55 tools with parameter tables, deployment).

Release history and changelog: GitHub Releases.

Deployment shapes and how to pick between them: see docs/deploy/.

Demo

24-second loop showing real output from the Claude iPhone app calling jquants-mcp tools:

  • Sector performance ranking (業種別騰落率) — getsectorperformance
  • Top turnover by trading value (売買代金ランキング) — gettopturnover_value
  • Candlestick chart with SMA — getcandlestickdata
  • Quarterly financial summary (決算ダイジェスト) — getfinssummary
  • 5-stock return comparison — getcomparisonchart_data

Individual frames are in docs/screenshots/.

Features

  • 55 MCP tools — 22 J-Quants API v2 endpoints, 11 market overview + valuation, 10 offline screener, 1 technical indicators, 1 single-stock summary, 3 cache-only equity search + earnings (schedule + results), 2 chart tools (JSON, no optional dependencies), and 5 server utilities
  • Two-tier SQLite cache — row-level cache for time-series data, response-level cache with TTL for others
  • Stock split detection — automatic cache invalidation when AdjFactor changes
  • Rate limiting — plan-aware sliding window (Free: 5/min, Light: 60, Standard: 120, Premium: 500)
  • Retry with backoff — automatic retry for 429/5xx errors
  • Pagination — transparent multi-page fetching
  • Plan-aware — all tools registered regardless of plan; graceful error messages on restriction

Requirements

  • Python 3.10+
  • J-Quants API key (Free plan or above)

Installation

# Using uv (recommended)
uv pip install jquants-mcp

# Using pip
pip install jquants-mcp

From source

git clone https://github.com/shigechika/jquants-mcp.git
cd jquants-mcp
uv sync --dev

Configuration

Settings are loaded with the following priority (later wins):

  1. ~/.jquants-api/jquants-api.toml — API key only (J-Quants official config)
  2. ~/.config/jquants-mcp/config.ini (user global)
  3. ./config.ini (current directory)
  4. Environment variables (from MCP client or shell)

API Key (zero-config)

If you already use jquants-api-client, your API key is automatically read from ~/.jquants-api/jquants-api.toml. No extra configuration needed.

API Key via browser login

jquants-mcp login

Opens a browser to J-Quants (AWS Cognito, PKCE flow), and on success writes the API key to ~/.config/jquants-mcp/config.ini (mode 0600). Same auth backend as the official jquants-cli. Use jquants-mcp logout to clear the saved key.

config.ini

MCP-specific settings (cache, client behavior):

[jquants]
# cache_dir = ~/.cache/jquants-mcp
# base_url = https://api.jquants.com/v2

[client]
# max_retries = 5
# retry_base_delay = 1.0
# max_pages = 10

[server]
# encryption_key = <random-secret>   # enables per-user API key storage (multi-user mode)
# allowed_emails = alice@example.com,bob@example.com

Environment Variables

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

J-Quants MCP: common questions

Is J-Quants MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the J-Quants MCP safety report
How do I install J-Quants MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does J-Quants MCP need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is J-Quants MCP maintained?
The last commit was 9 days ago (2026-10-26). The latest release is v1.5.2.
What can I use instead of J-Quants MCP?
Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, Akshare One MCP server and Zwldarren Akshare One MCP server. Compare all J-Quants MCP alternatives.
How does J-Quants MCP compare with other Finance MCP servers?
safety score 92/100 (higher than 95% of 1,761 Finance servers); tools 55 (the typical Finance server has 8); tools that change things 2% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to J-Quants MCP

Same job from other publishers: the closest match first, then the best rated.

All J-Quants MCP alternatives →
  • Tapetide - Indian Stock Market MCP
    48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
    A
  • Akshare One
    MCP server that provides access to Chinese stock market data using akshare-one
    A
  • Zwldarren Akshare One
    Provide access to Chinese stock market data including historical prices, real-time data, news, and…
    More from smithery.ai →
    A
  • Alpha Vantage
    Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
    A
  • Stock Screener
    Daily stock screens, RS ratings, market breadth and group rankings for 12 markets. No API keys.
    A

More from shigechika →