Is io.github.shigechika/jquants-mcp safe to use?

io.github.shigechika/jquants-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.shigechika/jquants-mcp?

io.github.shigechika/jquants-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.shigechika/jquants-mcp do?

io.github.shigechika/jquants-mcp provides 5 tools: get_sector_performance, get_top_turnover_value, get_candlestick_data, get_fins_summary, get_comparison_chart_data. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.shigechika/jquants-mcp?

io.github.shigechika/jquants-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.shigechika/jquants-mcp actively maintained?

io.github.shigechika/jquants-mcp is actively maintained — last commit was 20 days ago. It has 1 GitHub stars.

io.github.shigechika/jquants-mcp

skills

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

1 16.6M/wk 5 tools GitHub npm PyPI

No known CVEs

No license

Actively maintained

Last commit 20d ago

Works with most clients

Transport: stdio, sse, http

5 tools · ~228 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jquants-mcp": {
      "command": "/path/to/jquants-mcp/.venv/bin/jquants-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shigechika-jquants-mcp)](https://mcppedia.org/s/io-github-shigechika-jquants-mcp)

Read me

What io.github.shigechika/jquants-mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'skills' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

90/100across 5 weighted dimensions

How we score →

0255075100

−10

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked skills against OSV.dev.

Inventory

Tools (5)

Click any tool to inspect its schema.

~228 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.shigechika/jquants-mcp safe to use?: io.github.shigechika/jquants-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.shigechika/jquants-mcp?: io.github.shigechika/jquants-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.shigechika/jquants-mcp do?: io.github.shigechika/jquants-mcp provides 5 tools: get_sector_performance, get_top_turnover_value, get_candlestick_data, get_fins_summary, get_comparison_chart_data. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.shigechika/jquants-mcp?: io.github.shigechika/jquants-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.shigechika/jquants-mcp actively maintained?: io.github.shigechika/jquants-mcp is actively maintained — last commit was 20 days ago. It has 1 GitHub stars.

Similar servers

Others in finance

View all →

io.github.wyre-technology/qbo-mcp92

MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.

2 11

Printr MCP Server92

Let AI agents create, discover, and track tokens across chains via Printr.

3 9

Alpha Vantage Mcp91

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

178 3

io.github.imbenrabi/financial-modeling-prep-mcp-server90

MCP server for Financial Modeling Prep API with 250+ financial data tools

138 5

MCP Security Weekly

Get CVE alerts and security updates for io.github.shigechika/jquants-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jquants-mcp": {
      "command": "/path/to/jquants-mcp/.venv/bin/jquants-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shigechika-jquants-mcp)](https://mcppedia.org/s/io-github-shigechika-jquants-mcp)

Read me

What io.github.shigechika/jquants-mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'skills' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

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 43 tools with parameter tables, deployment).

Release history and changelog: GitHub Releases.

Deployment shapes (stdio / Docker Compose / self-hosted HTTP / Cloud Run) 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 (業種別騰落率) — get_sector_performance
Top turnover by trading value (売買代金ランキング) — get_top_turnover_value
Candlestick chart with SMA — get_candlestick_data
Quarterly financial summary (決算ダイジェスト) — get_fins_summary
5-stock return comparison — get_comparison_chart_data

Individual frames are in docs/screenshots/.

Features

54 MCP tools — 22 J-Quants API v2 endpoints, 10 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):

~/.jquants-api/jquants-api.toml — API key only (J-Quants official config)
~/.config/jquants-mcp/config.ini (user global)
./config.ini (current directory)
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]
# ssl_certfile = /path/to/fullchain.pem
# ssl_keyfile = /path/to/privkey.pem
# bearer_token = <secret>
# encryption_key = <random-secret>   # enables per-user API key storage (

... [View full README on GitHub](https://github.com/shigechika/jquants-mcp#readme)

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

90/100across 5 weighted dimensions

How we score →

0255075100

−10

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked skills against OSV.dev.

Inventory

Tools (5)

Click any tool to inspect its schema.

~228 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.shigechika/jquants-mcp safe to use?: io.github.shigechika/jquants-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.shigechika/jquants-mcp?: io.github.shigechika/jquants-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.shigechika/jquants-mcp do?: io.github.shigechika/jquants-mcp provides 5 tools: get_sector_performance, get_top_turnover_value, get_candlestick_data, get_fins_summary, get_comparison_chart_data. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.shigechika/jquants-mcp?: io.github.shigechika/jquants-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.shigechika/jquants-mcp actively maintained?: io.github.shigechika/jquants-mcp is actively maintained — last commit was 20 days ago. It has 1 GitHub stars.