J-Quants Free MCP server

Q: How do I obtain and set the required token?

Register at J-Quants API, get your ID token, and set it as the environment variable `JQUANTS_ID_TOKEN`.

@cygkichi

Repository

About J-Quants Free MCP server

J-Quants APIの無償版で利用可能な機能のMCPサーバー

#jquants #mcp-server #api

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "e-stat": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/jquants-free-mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is J-Quants Free MCP server?

A Model Context Protocol server that provides access to the free version of the J-Quants API, enabling retrieval of Japanese stock data and financial statements.

How to use J-Quants Free MCP server?

Register at J-Quants API to obtain an ID token, then set the JQUANTS_ID_TOKEN environment variable. Configure your MCP client (e.g., Claude Desktop) with the server path and that environment variable.

Key features of J-Quants Free MCP server

search_company: Search listed companies by Japanese text.
get_daily_quotes: Fetch daily stock prices by company code.
get_financial_statements: Retrieve financial statements by company code.
No paid subscription required for the underlying API.

Use cases of J-Quants Free MCP server

Compare financial ratios (e.g., equity ratio) of multiple companies.
Obtain balance sheets and create charts from financial data.
Automate daily stock price lookups for a watchlist.
Integrate Japanese equity data into an AI assistant's analysis.

FAQ from J-Quants Free MCP server

What tools does the server provide?

Three tools: search_company (text search), get_daily_quotes (daily prices), and get_financial_statements (financial statements).

How do I obtain and set the required token?

Can I use the server without a J-Quants API registration?

No, registration and an active ID token are mandatory.

What license applies to this project?

The project is distributed under the MIT License; see the LICENSE file.

What runtime or dependencies are needed?

The server runs with Python (via uv or uvx) and expects the JQUANTS_ID_TOKEN environment variable to be set.

Frequently asked questions

What tools does the server provide?

Three tools: `search_company` (text search), `get_daily_quotes` (daily prices), and `get_financial_statements` (financial statements).

How do I obtain and set the required token?

Can I use the server without a J-Quants API registration?

No, registration and an active ID token are mandatory.

What license applies to this project?

The project is distributed under the MIT License; see the LICENSE file.

What runtime or dependencies are needed?

The server runs with Python (via `uv` or `uvx`) and expects the `JQUANTS_ID_TOKEN` environment variable to be set.

Comments

Basic information

More Other MCP servers

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov