J-Quants Free MCP server

Name: J-Quants Free MCP server
Author: cygkichi

@cygkichi

Repository

About J-Quants Free MCP server

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

#jquants #mcp-server #api

Basic information

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K