Jquants Mcp

Access JPX stock market data via J-Quants API — search stocks, get daily OHLCV prices, financial summaries (revenue, profit, EPS, ROE), and earnings calendar...

Security Scan

The skill's requested binary and the two J-Quants credentials match its stated purpose (accessing J-Quants/TSE data); nothing in the SKILL.md or manifest asks for unrelated secrets or system access.

Purpose & Capability

Name/description, required binary (jquants-mcp), and required env vars (JQUANTS_MAIL_ADDRESS, JQUANTS_PASSWORD) all align with a CLI that authenticates to J-Quants and fetches market/financial data. The setup notes even mention pip install jquants-mcp, which is consistent.

Instruction Scope

SKILL.md only instructs running the jquants-mcp CLI with specific commands (search, price, financials, calendar, test). It references only the declared environment variables and the official J-Quants site/ToS. There are no instructions to read unrelated files, exfiltrate data, or contact third-party endpoints outside the stated API.

Install Mechanism

Install spec uses an 'uv' package installation that creates the jquants-mcp binary; SKILL.md also mentions 'pip install jquants-mcp'. This is proportionate to a CLI-based skill, but the trustworthiness depends on the package registry/source (uv registry or PyPI). Because the skill will install a binary package, users should verify the package origin before installing.

Credentials

Only two env vars are required: JQUANTS_MAIL_ADDRESS and JQUANTS_PASSWORD. Those are appropriate for authenticating a user account on J-Quants. There are no unrelated secrets, cloud credentials, or excessive environment access requested.

Persistence & Privilege

always is false, there are no required config paths, and the skill does not request to modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) but is not combined with unusual privileges.

Assessment

This skill appears coherent with its purpose, but take routine precautions before installing and running it: 1) Verify the jquants-mcp package on the source registry (PyPI or the 'uv' registry) and check the maintainer and code/release page if available. 2) Prefer using a dedicated J-Quants account or an API token if the service offers one rather than reusing your primary email/password. 3) Understand J-Quants Terms of Service — redistribution is prohibited. 4) Because the install creates a binary, inspect the package contents or source repository when possible and avoid installing from unknown/untrusted URLs. 5) If you have concerns, run the CLI in an isolated environment (container or VM) and monitor network calls during first use.

J-Quants: JPX Stock Market Data

Access Tokyo Stock Exchange (TSE) listed stock data via the official J-Quants API. Search stocks, get daily OHLCV prices, financial summaries, and earnings announcement calendar.

Important: This tool is for personal use only. Data redistribution is prohibited by J-Quants Terms of Service. https://jpx-jquants.com/termsofservice

Use Cases

• Search for TSE-listed stocks by code or company name
• Get daily OHLCV price data for any stock
• Retrieve financial summaries (revenue, profit, EPS, ROE)
• Check upcoming earnings announcement dates
• Compare financial metrics across companies

Commands

Search stocks

# By stock code
jquants-mcp search 7203

# By company name (Japanese)
jquants-mcp search トヨタ

# JSON output
jquants-mcp search ソニー --json-output

Get stock prices

# Default: last 30 days
jquants-mcp price 7203

# With date range
jquants-mcp price 7203 --start-date 2024-01-01 --end-date 2024-12-31

# JSON output
jquants-mcp price 7203 --json-output

Get financial data

jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output

Get earnings calendar

# Default: next 30 days
jquants-mcp calendar

# With date range
jquants-mcp calendar --start-date 2024-04-01 --end-date 2024-06-30

Test connectivity

jquants-mcp test

Workflow

1. jquants-mcp search <company> → find stock code
2. jquants-mcp price <code> → get price history
3. jquants-mcp financials <code> → get financial data
4. jquants-mcp calendar → check earnings dates

Setup

• Requires JQUANTS_MAIL_ADDRESS and JQUANTS_PASSWORD environment variables
• Free account registration: https://jpx-jquants.com/
• Python package: pip install jquants-mcp or uv tool install jquants-mcp

Terms of Service

By using this tool, you agree to the J-Quants Terms of Service. Data is for personal use only — redistribution is prohibited.