About J-Quants Free MCP server
J-Quants Free MCP server provides access to functions in the free J-Quants API. It is for clients that need to search Japanese listed companies and retrieve daily quotes or financial statements, using a J-Quants API ID token.
Key features
- 01Search listed companies in Japanese
- 02Retrieve daily stock quotes by code
- 03Retrieve financial statements by code
- 04Authenticate with a J-Quants ID token
Use cases
- 01Find listed companies from Japanese text
- 02Retrieve a company's daily share prices
- 03Get financial statements for comparison
MCP support
Exposes company search, daily quote, and financial statement tools to MCP clients. Access requires a J-Quants API ID token set in `JQUANTS_ID_TOKEN`.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJ-Quants Free MCP server
Model Context Protocol (MCP) サーバーで、無償版J-Quants APIのにアクセスするための機能を提供します。
ツール
このサーバーは以下のツールを提供しています:
search_company: 日本語のテキストから、上場銘柄を検索するget_daily_quotes: 銘柄コードから、日次の株価を取得するget_financial_statements: 銘柄コードから、財務諸表を取得する
使い方
このサーバーを使用するには、J-Quants APIへの登録が必要です。以下の手順で取得できます:
- J-Quants APIに登録
- IDトークンを取得しして、
JQUANTS_ID_TOKEN環境変数に設定
Claude Desktop
- On MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - On Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"e-stat": {
"command": "uv",
"args": [
"--directory",
"/path/to/jquants-free-mcp-server",
"run",
"server.py"
],
"env": {
"JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
}
}
}
}
{
"mcpServers": {
"e-stat": {
"command": "uvx",
"args": [
"jquants-free-mcp-server"
],
"env": {
"JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
}
}
}
}
使用例
例えばClaudeに以下のような質問ができます:
- "コメダとルノアールの自己資本比率を比較して"
- "UUUMとカバーとANYCOLORの財務表を取得して、バランスシートを図にしてください。"
ライセンス
このプロジェクトはMITライセンスの下で提供されています
- 詳細はLICENSEファイルを参照してください。
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.