J-Quants MCP

Name: J-Quants MCP
Author: shigechika

de shigechikaversión 1.5.2i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.shigechika/jquants-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 171/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Contabilidad, finanzas e impuestos

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
El registro no indica ninguna clave que completar.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "jquants": {
      "command": "uvx",
      "args": [
        "jquants-mcp"
      ]
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add jquants -- uvx jquants-mcp

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "jquants": {
      "command": "uvx",
      "args": [
        "jquants-mcp"
      ]
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "jquants": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jquants-mcp"
      ]
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub shigechika, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Contabilidad, finanzas e impuestosi

Más estrellas que el 0% de los otros 2949 servidores de esta categoría
Publicado en el registro más recientemente que el 69% de los otros 2949 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 2949 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro J-Quants MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.5.2) llegó al registro hace 13 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

de JerBoumaMuy usado↓ 15,5 mil/sem★ 5,5 milActualizado anteayer

Computadora o nube

Instalar

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 981Actualizado hace 9 días

Se ejecuta en la nube✓ solidinvoice.co

Instalar

Korea Tax Calculator

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

de UpstageAIEn crecimiento↓ 3,2 mil/sem★ 97Actualizado hoy

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Release history and changelog: GitHub Releases.

Deployment shapes 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

55 MCP tools — 22 J-Quants API v2 endpoints, 11 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]

encryption_key = # enables per-user API key storage (multi-user mode)

allowed_emails = alice@example.com,bob@example.com

Environment Variables

Variable	Required	Default	Description
`JQUANTS_API_KEY`	No*	—	J-Quants API key
`JQUANTS_API_TOML_PATH`	No	`~/.jquants-api/jquants-api.toml`	Path to the J-Quants official config file. Override to avoid macOS 26+ launchd sandbox restrictions (see macOS launchd note below)
`JQUANTS_PLAN`	No	auto-detect	Plan: `free` / `light` / `standard` / `premium` (auto-detected from the API key at server startup; set this variable only to override)
`JQUANTS_CACHE_DIR`	No	`~/.cache/jquants-mcp`	Cache directory path
`JQUANTS_BASE_URL`	No	`https://api.jquants.com/v2`	API base URL
`MAX_RETRIES`	No	`5`	Max retry attempts for failed requests
`RETRY_BASE_DELAY`	No	`1.0`	Base delay (seconds) for exponential backoff
`MAX_PAGES`	No	`10`	Max pages to fetch per paginated request
`JQUANTS_MCP_USER`	No	—	Identity of the authenticated user, injected by the gateway (see Authentication). Never set this by hand
`MCP_ENCRYPTION_KEY`	No	—	Passphrase for AES-256-GCM encryption of per-user API keys
`MCP_ENCRYPTION_KEY_PREVIOUS`	No	—	Previous encryption passphrase — enables dual-key decrypt during a rotation window. See secrets rotation runbook
`RATE_LIMIT_PER_MINUTE`	No	`60`	Per-user request ceiling (multi-user mode). Applies per `JQUANTS_MCP_USER` identity
`RATE_LIMIT_BURST`	No	`20`	Per-user burst allowance (token-bucket capacity)
`JQUANTS_ALLOWED_EMAILS`	No	—	Comma-separated allowlist of emails. Empty = allow any user the gateway authenticated (self-host default). Set this on public Cloud Run instances to restrict access; unauthorized users get a 403-style message pointing them to self-host

\* API key is auto-detected from ~/.jquants-api/jquants-api.toml. Set JQUANTS_API_KEY only to override.

Environment variables override both config.ini and jquants-api.toml. This allows MCP clients (Claude Desktop, Claude Code, Codex, …) to pass settings via their env block while keeping defaults elsewhere.

macOS launchd note

If you run jquants-mcp as a macOS LaunchAgent and the API key lives in ~/.jquants-api/jquants-api.toml, the server may silently hang during startup on macOS 26 or later. The TCC sandbox applied to launchd-spawned processes blocks open() on some dotfiles under $HOME (mode 600), and the process never finishes starting.

Workaround: copy the toml outside the sandboxed home hierarchy and point the server at it via JQUANTS_API_TOML_PATH:

sudo mkdir -p /usr/local/etc/jquants-mcp

sudo cp ~/.jquants-api/jquants-api.toml /usr/local/etc/jquants-mcp/jquants-api.toml sudo chown "$USER":staff /usr/local/etc/jquants-mcp/jquants-api.toml sudo chmod 600 /usr/local/etc/jquants-mcp/jquants-api.toml

Then add the following to your LaunchAgent plist's EnvironmentVariables dict:

<key>JQUANTS_API_TOML_PATH</key>

/usr/local/etc/jquants-mcp/jquants-api.toml

Alternatives: set JQUANTS_API_KEY directly in the plist (simpler but puts the key in a plist file that Time Machine / iCloud may back up), or put api_key = directly in ~/.config/jquants-mcp/config.ini (if that path is not sandbox-blocked on your macOS version).

Linux/systemd and other init systems are not affected.

Authentication

The server speaks stdio only and binds no network socket, so it performs no authentication of its own — there is no listener to authenticate against. Access control is a property of whoever starts the process:

Deployment	Who controls access
Local (Claude Code, Claude Desktop, Codex, …)	The OS. The MCP client spawns the server as a subprocess; the API key comes from `config.ini` / `jquants-api.toml` / `JQUANTS_API_KEY`
Remote	A gateway in front of the server. The gateway terminates authentication and spawns the stdio server per session

Gateway identity

For remote or multi-user deployments, put a gateway in front of the stdio server. mcp-stdio serve is the gateway both production deployments use: it accepts MCP over HTTP, authenticates the caller, and spawns one jquants-mcp child process per session.

The gateway passes the authenticated identity down to that child as the JQUANTS_MCP_USER environment variable (mcp-stdio serve --trusted-user-header X-Forwarded-Email --user-env JQUANTS_MCP_USER). One child process serves exactly one principal for its whole lifetime, and the server reads JQUANTS_MCP_USER as that principal's verified email — it applies the JQUANTS_ALLOWED_EMAILS allowlist and per-user rate limits to it, and looks up that user's stored API key.

Trust model: JQUANTS_MCP_USER is trusted as-is; the server does no verification of its own. Whoever can set the child process's environment *is* that user, so the variable must be injected by the gateway and never by a user-supplied value.

When JQUANTS_MCP_USER is absent — the normal local case — the server runs single-user against the globally configured API key.

A worked example of the whole shape (auth proxy in front, gateway, stdio child, cache download) is scripts/entrypoint-stdio.sh, the entrypoint of the Cloud Run deployment described below. There is no other documented remote-access story: the server itself has no transport, TLS, or token options.

Multi-user Mode

When the server receives a gateway identity (JQUANTS_MCP_USER, see Authentication) and MCP_ENCRYPTION_KEY is configured, it operates in multi-user mode: each user stores their own J-Quants API key on the server, and all data tools use that key automatically. All users share the read cache; each user gets an independent J-Quants client with isolated rate limiting and their own plan's date-range window.

User flow

sequenceDiagram

participant U as User participant C as MCP client participant G as Gateway (mcp-stdio serve) participant S as jquants-mcp (stdio child) participant J as J-Quants API U->>C: Connect C->>G: Authenticate (gateway's own auth layer) G->>S: Spawn child with JQUANTS_MCP_USER = verified email U->>C: "Register my J-Quants API key: " C->>G: register_api_key(api_key=" ") G->>S: forward over stdio S->>J: Probe plan-specific endpoints (auto-detect) J-->>S: Detected plan S->>S: Encrypt & store key + plan (AES-256-GCM) S-->>C: {"status": "ok", "plan": " "} U->>C: "Get TOPIX daily prices" C->>S: get_indices_bars_daily_topix(...) S->>J: API call with user's key J-->>S: Data S-->>C: Result

Tools for multi-user mode

Tool	Required	Description
`register_api_key`	`JQUANTS_MCP_USER` + `MCP_ENCRYPTION_KEY`	Encrypt and store your J-Quants API key
`delete_api_key`	`JQUANTS_MCP_USER` + `MCP_ENCRYPTION_KEY`	Remove your stored key

Both tools return an explanatory error instead of failing silently when either requirement is missing.

Registering a key (tell your AI agent):

"Register my J-Quants API key: "

The agent calls register_api_key(api_key="..."). The server probes plan-specific endpoints with the key to auto-detect the plan (free / light / standard / premium) and stores it alongside the encrypted key — no manual selection needed. Subsequent tool calls use the detected plan for rate limiting and date-range restrictions.

This is the only way to register a key on a multi-user deployment; the server exposes no web form and no HTTP endpoint of any kind.

Security

API keys are encrypted with AES-256-GCM (authenticated encryption — integrity-protected)
The encryption key is derived via PBKDF2-HMAC-SHA256 (200,000 iterations) from MCP_ENCRYPTION_KEY, with a random 16-byte salt per encryption
Each ciphertext uses a unique random 12-byte nonce — encrypting t

Solo se muestra el principio; lee el resto en el repo

J-Quants MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Contabilidad, finanzas e impuestosi

Preguntas frecuentes

Alternativas

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README del creador

jquants-mcp

Demo

Features

Requirements

Installation

Using pip

From source

Configuration

API Key (zero-config)

API Key via browser login

config.ini

cache_dir = ~/.cache/jquants-mcp

base_url = https://api.jquants.com/v2

max_retries = 5

retry_base_delay = 1.0

max_pages = 10

encryption_key = # enables per-user API key storage (multi-user mode)

allowed_emails = alice@example.com,bob@example.com

Environment Variables

macOS launchd note

Authentication

Gateway identity

Multi-user Mode

User flow

Tools for multi-user mode

Security