Japan Stock Market Data MCP (TSE Screener)

io.github.atushi1841Published by GitHub account atushi1841v0.1.5Updated Oct 24, 2026

Japan TSE stock screen Apify:apify.com/fruitful_quintessence | Gumroad:atushi5.gumroad.com/l/kutuxe

VerifiedSTDIODesktop onlyFinance Data & Analytics

Server details

Identifier: io.github.atushi1841/japan-stock-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Oct 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account atushi1841 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.atushi1841%2Fjapan-stock-mcp.svg)](https://sourceweft.com/mcp/io.github.atushi1841%2Fjapan-stock-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant query Tokyo Stock Exchange quotes, screen Japanese stocks and pull valuation and financial summaries via the official J-Quants API.

What you can do: Fetch latest daily OHLCV quotes for a given stock code. Screen Japanese stocks by market, sector, market cap, price and price change. Look up valuation metrics such as market cap, PER, PBR and dividend yield. Retrieve quarterly cumulative revenue, operating profit and net income summaries. Check the trading calendar and holiday list, and map 33-sector and 17-sector classification codes.
When to use it: Use it when an assistant needs Tokyo Stock Exchange quotes, screening of Japanese stocks by market or sector, or valuation and financial summaries. It suits research and first-pass screening, not real-time trading decisions.
Requirements: Runs locally with Python 3.10 or later and the fastmcp or mcp package. Needs a free J-Quants account at JPX and an API key supplied through the JQUANTS_API_KEY environment variable. Needs network access to the official API.

Before you install

Requires a J-Quants API key (environment variable JQUANTS_API_KEY) that should be kept private. The free plan lags data by 12 weeks, so it is unsuitable for real-time trading decisions. The README also promotes paid Apify and Gumroad data and services, which is third-party commercial content.

Installation

In SourceWeft

Open Japan Stock Market Data MCP (TSE Screener) in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Japan Stock Market Data MCP（東証株価・市場データ・日本株 screener）

TSE 株式・市場データ MCP サーバー — 東京証券取引所の株価・市場データを AI エージェントに提供。

公式 API（J-Quants / JPX）を使用するため TOS リスクなし・無料枠あり。

Tools（MCP ツール一覧）

ツール名	機能
`get_quote(code, days)`	指定銘柄の最新日足 OHLCV（高値・安値・出来高含む）
`screener(market, sector, min_market_cap, ...)`	市場・業種・時価総額・価格・値幅で株をスクリーニング
`get_valuation(code)`	時価総額・PER・PBR・配当利回り
`get_financial_summary(code, period)`	売上高・営業利益・純利益（四半期累計）
`get_calendar(year, month)`	取引カレンダー（休日リスト）
`sector_list()`	33業種 / 17業種分類コードマッピング

動作要件

Python >= 3.10、fastmcp / mcp
無料枠: J-Quants 無料プラン（12週間データラグ）
認証: JQUANTS_API_KEY 環境変数（https://jpx-jquants.com で無料登録）
完全ローカル実行（stdio / HTTP 両対応）

Quickstart

bash

# 1. クローンgit clone https://github.com/atushi1841/japan-stock-mcp.gitcd japan-stock-mcp
# 2. 依存pip install fastmcp
# 3. stdio mode で起動（Claude Desktop 等から接続）export JQUANTS_API_KEY="your-free-key"python server.py
# 4. HTTP mode で起動python server.py --http --port 8000

# 1. クローンgit clone https://github.com/atushi1841/japan-stock-mcp.gitcd japan-stock-mcp
# 2. 依存pip install fastmcp
# 3. stdio mode で起動（Claude Desktop 等から接続）export JQUANTS_API_KEY="your-free-key"python server.py
# 4. HTTP mode で起動python server.py --http --port 8000

動作確認

bash

python server.py --http --port 8000 &sleep 2curl -s -X POST http://localhost:8000/mcp/tools/list \  -H "Content-Type: application/json" \  -d '{}' | jq '.tools[].name'

python server.py --http --port 8000 &sleep 2curl -s -X POST http://localhost:8000/mcp/tools/list \  -H "Content-Type: application/json" \  -d '{}' | jq '.tools[].name'

MCP 公開レジストリ登録状況

レジストリ	状態	備考
MCP 公式レジストリ	✅ 登録済み	`io.github.atushi1841/japan-stock-mcp`
Smithery	📝 未登録	MCPB バンドル作成済（v0.1.0）— 公開はユーザー手動操作待ち
mcp.so	📝 未登録	YAML テンプレ準備中

Apify Actor

関連するApifyアクターで同じデータをAPI経由で取得可能:

Actor名	説明	URL
japan-market-mcp	中古品価格比較MCP（カメラ・時計・ブランド品・楽器・車・楽天）	apify.actor
japan-market-mcp GitHub	上記のオープンソース版	github.com

J-Quants公式APIを使用する本リポジトリとは別に、スクレイピング型Actorsも提供。

License

MIT License.

Data & Store

Apify Store: https://apify.com/fruitful_quintessence
Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe

Source: README.md at commit eede4f1

Tools

SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

v0.1.5LatestOct 24, 2026
v0.1.4Oct 22, 2026
v0.1.0Oct 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.