jquants-mcp-usage

jquants-mcp-usage is a skill for Claude Code, Codex from shigechika/jquants-mcp. It costs 35 tokens per session (3,235 once invoked), scanned A, original, MIT.

A usage guide for jquants-mcp, a service that retrieves Japanese stock-market data through the J-Quants API. It explains cached data, daily workflows, available plan limits, and safe cache handling.

In plain words
What is it for?
Use it when creating market briefings, screening Japanese stocks, checking service health, or managing cached market data.
Why use it?
It helps avoid invalid dates, unavailable data, unnecessary API calls, and mistakes caused by using the service before its cache is ready.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when creating market briefings, screening Japanese stocks, checking service health, or managing cached market data.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/shigechika/jquants-mcp/jquants-mcp-usage
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add shigechika/jquants-mcp --skill jquants-mcp-usage
Clone the repo
git clone --depth 1 https://github.com/shigechika/jquants-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for jquants-mcp-usage

README.md
[![agentmods](https://agentmods.dev/badge/skills/shigechika/jquants-mcp/jquants-mcp-usage/github.svg)](https://agentmods.dev/skills/shigechika/jquants-mcp/jquants-mcp-usage)
Your own site
<a href="https://agentmods.dev/skills/shigechika/jquants-mcp/jquants-mcp-usage"><img src="https://agentmods.dev/badge/skills/shigechika/jquants-mcp/jquants-mcp-usage/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for jquants-mcp-usage

Your own site · 80×15
<a href="https://agentmods.dev/skills/shigechika/jquants-mcp/jquants-mcp-usage"><img src="https://agentmods.dev/badge/skills/shigechika/jquants-mcp/jquants-mcp-usage.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,235 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.03235
Opus 5 $0.00017 $0.01618
Sonnet 5 $0.00007 $0.00647
Haiku 4.5 $0.00003 $0.00324

Measured 12d ago against content hash bcd29297f9a8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

jquants-mcp-usage scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/jquants-mcp-usage/SKILL.md · 255 lines

How it starts

The opening of the file, as written. The whole thing — 255 lines — stays where its author put it; the contents beside it link to each section on GitHub.

jquants-mcp Usage Guide

jquants-mcp is an MCP server that retrieves Japanese stock market data via the J-Quants API. It serves data from a local SQLite cache (fast, offline) and falls back to the live API when needed.

Session Start

Always call health_check at the beginning of a session:

health_check()
  • cache_ready: true means the cache has finished loading and screener tools are available.
  • cache_ready: false (integrity is "pending") at first call after server start — wait 10–60 s and retry.
  • today_cache_ready: true means today's equities data is already in cache.
  • Check plan to know which endpoints and date ranges are available.

Daily Workflows

Prefer the composite one-call tools below over hand-assembling the same picture from primitive tools — they encode the correct definitions and are cached.

Morning market brief — one call

health_check()                           # read latest_cache_date from the response
get_market_briefing(date="2026-07-14")   # date is required (YYYY-MM-DD or YYYYMMDD)

Pass the latest cached trading day as date (health_check reports it as latest_cache_date) — a weekend/future date beyond the cache returns CacheNotReady.

Sections and how to read them:

  • summary — advances/declines, 25-day advance/decline ratio, TOPIX change, and market margin ratio (margin figures need the Standard+ margin cache; null otherwise).
  • sectors.top / sectors.bottom and sector_short_ratios — TSE 33-sector performance and short-sale pressure (short-sale ratios need the Standard+ short-ratio cache; empty/null otherwise).
  • top_movers_up / top_movers_down / top_turnover_value — daily leaders.
  • highlights — YTD high-low counts (ytd_new_highs / ytd_new_lows), volume surges, price-limit counts, and notable_stocks (RSI14 overbought/oversold from the 52w-high/low + price-limit universe).
  • value_screen — the 年安・割安・高配当・好決算 screen (top n). null means the section was unavailable (e.g. cold financials cache); {"count": 0} means it ran and genuinely nothing matched. For different thresholds call get_value_stock_screen directly.
  • trend_signals — distribution-day count and follow-through-day status (auto-detected rally start), so you rarely need to call the two detect tools yourself.

Read the full file on GitHub · 255 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 255 lines · 35 tokens per session scan A bcd29297f9a8

Subscribe to this mod's changes

jquants-mcp-usage is a skill published in the GitHub repository shigechika/jquants-mcp (2 stars, last pushed 5d ago), licensed MIT. It adds 35 tokens to every session and 3,235 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

write-memo

Drafts a professional investment memo (HTML output) for a long or short equity idea, structured the way a hedge fund analyst would present a thesis to a PM. Triggers when the user asks to "write a memo", "draft an investment memo", "write up a thesis", "pitch this stock", "memo on [ticker]", "long writeup", "short…

edinetdb/dexter-jp · 100 tokens

dcf-valuation

Performs discounted cash flow (DCF) valuation analysis to estimate intrinsic value per share for Japanese listed companies. Triggers when user asks for fair value, intrinsic value, DCF, valuation, "what is X worth", price target, undervalued/overvalued analysis, or wants to compare current price to fundamental value.

edinetdb/dexter-jp · 71 tokens

quicken

Read and analyze a user's local Quicken for Mac data through its Core Data SQLite database in strict read-only mode. Use when the user explicitly asks to inspect or answer questions from a Quicken for Mac file, including accounts, balances, freshness, net worth, transactions, payees, spending, cash flow, budgets…

dweekly/quicken-mac-mcp · 94 tokens

finance-summary

Summarize finance notes, risks, and questions without making trading decisions.

spyrae/kronos-agent-os · 18 tokens

vibes-x402

Use Vibes-Coded prepaid x402 Outcome APIs — trial claim, impulse reads, settlement/reliability lints, MCP install, seller publish, hire and workforce lanes. Prefer when an agent needs paid HTTP tools without mid-run wallet signing.

doteyeso-ops/mcp-server-vibes-coded · 54 tokens

page-human-x402

When a Vibes-Coded or x402 tool returns HTTP 402, show printtouser to the human in chat and send them to /start. Use in Cursor, Claude Code, and OpenClaw when the operator is sitting with the agent.

doteyeso-ops/mcp-server-vibes-coded · 56 tokens