J-Quants MCP
Connects Claude to the J-Quants API v2 for Japanese stock market data. Ships with 51 tools covering equities, financials, sector performance, technical indicators, and screeners. The implementation includes a two-tier SQLite cache with automatic split detection, plan-aware rate limiting (Free through Premium tiers), and built-in retry logic for API failures. Configuration is zero-touch if you already use jquants-api-client. Deployment options range from stdio in Claude Desktop to self-hosted HTTP with GitHub or Google OAuth for multi-user scenarios. Useful if you're building equity research workflows, tracking Nikkei constituents, or running quantitative screens on Japanese markets without writing your own API client.
- GitHub stars
- 3
- tools
- 51
- transport
- STDIO
- last updated
- Oct 26, 2026
Tools
51 toolsPublic tool metadata for what this MCP can expose to an agent.
register_api_keyEncrypt and store your J-Quants API key
Encrypt and store your J-Quants API key
No parameter schema in public metadata yet.
delete_api_keyRemove your stored key
Remove your stored key
No parameter schema in public metadata yet.
get_equities_masterListed issue information
Listed issue information
No parameter schema in public metadata yet.
get_equities_bars_dailyDaily stock prices (OHLC)
Daily stock prices (OHLC)
No parameter schema in public metadata yet.
get_equities_bars_minuteMinute-level stock prices
Minute-level stock prices
No parameter schema in public metadata yet.
get_equities_bars_daily_amMorning session prices
Morning session prices
No parameter schema in public metadata yet.
get_equities_investor_typesTrading by investor type
Trading by investor type
No parameter schema in public metadata yet.
get_equities_earnings_calendarEarnings schedule (single date or by code); Light+ covers all listed issues incl. REITs, Free is limited to March/September fiscal-year issues
Earnings schedule (single date or by code); Light+ covers all listed issues incl. REITs, Free is limited to March/September fiscal-year issues
No parameter schema in public metadata yet.
get_earnings_this_weekCompanies reporting earnings in a date window, grouped by day (default today..+7d)
Companies reporting earnings in a date window, grouped by day (default today..+7d)
No parameter schema in public metadata yet.
search_equitiesReverse lookup by company name (e.g. "住友商事" → 8053)
Reverse lookup by company name (e.g. "住友商事" → 8053)
No parameter schema in public metadata yet.
get_fins_summaryFinancial summary (quarterly)
Financial summary (quarterly)
No parameter schema in public metadata yet.
get_fins_detailsDetailed statements (BS/PL/CF)
Detailed statements (BS/PL/CF)
No parameter schema in public metadata yet.
get_fins_dividendCash dividend data
Cash dividend data
No parameter schema in public metadata yet.
get_earnings_results_this_weekEarnings results disclosed in a date window (default last 7d), grouped by day with headline P&L + forecast progress
Earnings results disclosed in a date window (default last 7d), grouped by day with headline P&L + forecast progress
No parameter schema in public metadata yet.
get_indices_bars_dailyIndex daily prices
Index daily prices
No parameter schema in public metadata yet.
get_indices_bars_daily_topixTOPIX daily prices
TOPIX daily prices
No parameter schema in public metadata yet.
get_derivatives_bars_daily_futuresFutures daily prices
Futures daily prices
No parameter schema in public metadata yet.
get_derivatives_bars_daily_optionsOptions daily prices
Options daily prices
No parameter schema in public metadata yet.
get_derivatives_bars_daily_options_225Nikkei 225 options prices
Nikkei 225 options prices
No parameter schema in public metadata yet.
get_markets_margin_interestMargin trading data
Margin trading data
No parameter schema in public metadata yet.
get_markets_margin_alertMargin trading alerts
Margin trading alerts
No parameter schema in public metadata yet.
get_markets_short_ratioShort selling ratio
Short selling ratio
No parameter schema in public metadata yet.
get_markets_short_sale_reportShort sale position report
Short sale position report
No parameter schema in public metadata yet.
get_markets_breakdownMarket breakdown by investor
Market breakdown by investor
No parameter schema in public metadata yet.
get_markets_calendarTrading calendar
Trading calendar
No parameter schema in public metadata yet.
get_bulk_listList downloadable CSV files
List downloadable CSV files
No parameter schema in public metadata yet.
get_bulk_download_urlGet signed download URL
Get signed download URL
No parameter schema in public metadata yet.
detect_price_changeDaily advance/decline summary (値上がり/値下がり銘柄数) and advance-decline ratio.
Daily advance/decline summary (値上がり/値下がり銘柄数) and advance-decline ratio.
No parameter schema in public metadata yet.
get_advance_decline_ratioCumulative advance/decline ratio (騰落レシオ) over the last period trading days. Default 25 (overbought >120, oversold <70).
Cumulative advance/decline ratio (騰落レシオ) over the last period trading days. Default 25 (overbought >120, oversold <70).
No parameter schema in public metadata yet.
get_top_moversTop gainers/losers ranked by percentage price change. Returns code + name + change_pct.
Top gainers/losers ranked by percentage price change. Returns code + name + change_pct.
No parameter schema in public metadata yet.
get_top_volumeTop stocks by trading volume (出来高ランキング, share count). Returns code + name + volume + turnover_value.
Top stocks by trading volume (出来高ランキング, share count). Returns code + name + volume + turnover_value.
No parameter schema in public metadata yet.
get_top_turnover_valueTop stocks by turnover value (売買代金ランキング, yen). Surfaces high-priced large-caps that dominate institutional flow, distinct from get_top_volume.
Top stocks by turnover value (売買代金ランキング, yen). Surfaces high-priced large-caps that dominate institutional flow, distinct from get_top_volume.
No parameter schema in public metadata yet.
get_sector_performanceSector-level average daily change (業種別騰落率) grouped by TSE 33 sectors (default) or 17 sectors (sector_type="s17").
Sector-level average daily change (業種別騰落率) grouped by TSE 33 sectors (default) or 17 sectors (sector_type="s17").
No parameter schema in public metadata yet.
get_sector_briefingSector-level median PER, PBR, and ROE (業種別ブリーフィング) aggregated from the most recent FY financials. Split-adjusted. Sorted by PER ascending (cheapest first).
Sector-level median PER, PBR, and ROE (業種別ブリーフィング) aggregated from the most recent FY financials. Split-adjusted. Sorted by PER ascending (cheapest first).
No parameter schema in public metadata yet.
get_dividend_yield_rankingHigh dividend yield stock ranking (高配当利回りランキング). Joins DivAnn from fins_summary with AdjC to compute yield_pct = DivAnn / AdjC × 100. Skips interim reports with empty DivAnn.
High dividend yield stock ranking (高配当利回りランキング). Joins DivAnn from fins_summary with AdjC to compute yield_pct = DivAnn / AdjC × 100. Skips interim reports with empty DivAnn.
No parameter schema in public metadata yet.
get_valuation_rankingPER/PBR valuation ranking (バリュエーションランキング). Joins latest-FY EPS/BPS with AdjC (split-adjusted) across all stocks; default 20 cheapest by PER. Excludes net-loss (EPS≤0, PER) / negative-book (BPS≤0, PBR). metric, min_value/max_value, market, sector, disc_months filters.
PER/PBR valuation ranking (バリュエーションランキング). Joins latest-FY EPS/BPS with AdjC (split-adjusted) across all stocks; default 20 cheapest by PER. Excludes net-loss (EPS≤0, PER) / negative-book (BPS≤0, PBR). metric, min_value/max_value, market, sector, disc_months filters.
No parameter schema in public metadata yet.
get_value_stock_screenCombined value screen (年安・割安・高配当・好決算スクリーニング) — ALL criteria must hold: close within near_low_pct % of the 52-week low (or fresh 52w low), PER < max_per AND PBR < max_pbr, forward dividend yield ≥ min_yield %, and a profit-increase forecast (NxFNp/FNP > NP). Split-adjusted, REI...
Combined value screen (年安・割安・高配当・好決算スクリーニング) — ALL criteria must hold: close within near_low_pct % of the 52-week low (or fresh 52w low), PER < max_per AND PBR < max_pbr, forward dividend yield ≥ min_yield %, and a profit-increase forecast (NxFNp/FNP > NP). Split-adjusted, REI...
No parameter schema in public metadata yet.
get_market_briefingComposite daily briefing (相場ブリーフィング) — advance/decline + 25-day ADR + sector top/bottom + top movers + top turnover + screener highlights + value screen + TOPIX change in one call.
Composite daily briefing (相場ブリーフィング) — advance/decline + 25-day ADR + sector top/bottom + top movers + top turnover + screener highlights + value screen + TOPIX change in one call.
No parameter schema in public metadata yet.
detect_price_limitFind stocks that touched the daily upper/lower price limit (ストップ高/安) using the UL/LL flags. Optional close-at-limit refinement via C == H / C == L.
Find stocks that touched the daily upper/lower price limit (ストップ高/安) using the UL/LL flags. Optional close-at-limit refinement via C == H / C == L.
No parameter schema in public metadata yet.
compare_close_vs_vwapCompute the daily VWAP (Va / Vo) and compare to the close for a given code + date or date range.
Compute the daily VWAP (Va / Vo) and compare to the close for a given code + date or date range.
No parameter schema in public metadata yet.
detect_52w_high_lowNew 52-week rolling high/low (Yahoo / Bloomberg / TradingView convention). Returns new_high / new_high_close / new_low / new_low_close plus conviction context: AdjO, close_vs_vwap ("above"/"below"), volume_ratio, volume_ratio_sessions.
New 52-week rolling high/low (Yahoo / Bloomberg / TradingView convention). Returns new_high / new_high_close / new_low / new_low_close plus conviction context: AdjO, close_vs_vwap ("above"/"below"), volume_ratio, volume_ratio_sessions.
No parameter schema in public metadata yet.
detect_52w_high_low_rangeSame as above but across a date range (date_from–date_to). Use this instead of repeated single-date calls.
Same as above but across a date range (date_from–date_to). Use this instead of repeated single-date calls.
No parameter schema in public metadata yet.
detect_ytd_high_lowNew year-to-date (年初来) high/low (Kabutan / JPX / Yahoo!ファイナンス convention). Same four signals against the YTD prior window plus AdjO, close_vs_vwap, volume_ratio, volume_ratio_sessions.
New year-to-date (年初来) high/low (Kabutan / JPX / Yahoo!ファイナンス convention). Same four signals against the YTD prior window plus AdjO, close_vs_vwap, volume_ratio, volume_ratio_sessions.
No parameter schema in public metadata yet.
detect_ytd_high_low_rangeSame as above but across a date range (date_from–date_to). Use this instead of repeated single-date calls.
Same as above but across a date range (date_from–date_to). Use this instead of repeated single-date calls.
No parameter schema in public metadata yet.
detect_volume_surgeList stocks whose volume on date exceeds the trailing 20-day average by a configurable multiplier (default 2.0).
List stocks whose volume on date exceeds the trailing 20-day average by a configurable multiplier (default 2.0).
No parameter schema in public metadata yet.
detect_distribution_daysIdentify distribution days (機関投資家の売り圧力) using TOPIX as the market proxy and total market turnover (SUM(Va)) as the volume signal. A distribution day fires when TOPIX falls ≥ sigma_multiplier σ (default 2.0) below the 20-session rolling mean. Four or more within window_sessions...
Identify distribution days (機関投資家の売り圧力) using TOPIX as the market proxy and total market turnover (SUM(Va)) as the volume signal. A distribution day fires when TOPIX falls ≥ sigma_multiplier σ (default 2.0) below the 20-session rolling mean. Four or more within window_sessions...
No parameter schema in public metadata yet.
detect_follow_through_dayConfirm a new uptrend (フォロースルーデイ). TOPIX must rise ≥ sigma_multiplier σ (default 2.0) above the 20-session rolling mean on session 4 or later from rally_start (the low/reversal day), with higher total market Va than the prior session. Provide the first day of the rally attempt...
Confirm a new uptrend (フォロースルーデイ). TOPIX must rise ≥ sigma_multiplier σ (default 2.0) above the 20-session rolling mean on session 4 or later from rally_start (the low/reversal day), with higher total market Va than the prior session. Provide the first day of the rally attempt...
No parameter schema in public metadata yet.
detect_consecutive_dividend_increaseScreen for stocks with at least min_years (default 10) consecutive years of annual dividend increase (連続増配). Split-adjusted. Supports as_of_date for lookahead-free back-testing. Results sorted by consecutive years descending; each entry includes code, name, consecutive_years,...
Screen for stocks with at least min_years (default 10) consecutive years of annual dividend increase (連続増配). Split-adjusted. Supports as_of_date for lookahead-free back-testing. Results sorted by consecutive years descending; each entry includes code, name, consecutive_years,...
No parameter schema in public metadata yet.
get_stock_briefingOne-page briefing for a single stock (株式ブリーフィング): latest price (close, change_pct, volume, OHLC), most recent FY financials (revenue, operating profit, net income), and valuation ratios (PER, PBR, ROE, EPS, BPS, dividend yield). All figures are split-adjusted. PER is null when...
One-page briefing for a single stock (株式ブリーフィング): latest price (close, change_pct, volume, OHLC), most recent FY financials (revenue, operating profit, net income), and valuation ratios (PER, PBR, ROE, EPS, BPS, dividend yield). All figures are split-adjusted. PER is null when...
No parameter schema in public metadata yet.
get_technical_indicatorsCompute SMA (5/25/75), Bollinger Bands (bb20, ±2σ sample std), and RSI (rsi14, Wilder smoothing) for a single code over a date or date range. Returns numeric values — useful for "is close above SMA25?" or "is RSI overbought?" without rendering a chart. All values use split-adj...
Compute SMA (5/25/75), Bollinger Bands (bb20, ±2σ sample std), and RSI (rsi14, Wilder smoothing) for a single code over a date or date range. Returns numeric values — useful for "is close above SMA25?" or "is RSI overbought?" without rendering a chart. All values use split-adj...
No parameter schema in public metadata yet.
get_candlestick_dataOHLCV + indicator data as JSON parallel arrays for a single code. Returns dates, ohlcv, indicators (SMA / Bollinger), lock_days, earnings_dates. Default: 91-day range, sm
OHLCV + indicator data as JSON parallel arrays for a single code. Returns dates, ohlcv, indicators (SMA / Bollinger), lock_days, earnings_dates. Default: 91-day range, sm
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
jquants-mcp
English | 日本語
An MCP (Model Context Protocol) server that retrieves Japanese stock market data via J-Quants API v2.
User-facing documentation site: https://shigechika.github.io/jquants-mcp/ (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 on the Claude iPhone app cycling through sector performance, top turnover ranking, candlestick chart with SMA, quarterly financial summary, and a 5-stock return comparison
24-second loop showing real output from the Claude iPhone app calling jquants-mcp tools:
Details
- Repository
- github.com/shigechika/jquants-mcp
- Category
- Data & Analytics
- Package
jquants-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from shigechika
Related Data & Analytics MCP servers
View all
Mcp Datahubtxn2/mcp-datahubMCP server for DataHub data catalogs. Discover datasets, explore lineage, and access metadata.3stars
Windsor.ai MCPwindsor-ai/windsor_mcpQuery and analyze marketing, sales, and business data from 325+ platforms via Windsor.ai.3stars
Alphago2580 Naramarketmcpalphago2580/naramarketmcpAccess Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…2stars
pipeverifyakshaysharma1088/pipeverifyRead-only check that a pipeline change left the data right: pass, review or block.2stars
travel.artalexzavialov/travel-art-mcpArt-tourism data for AI agents: biennales, art fairs, museums, layover itineraries with 2026 facts.2stars
GoldenCheckbenseverndev-oss/goldencheckAuto-discover validation rules from data — scan, profile, health-score. No rules to write.2stars