Skip to main content
Glama
ajtgjmdjp

japanfinance-agent

by ajtgjmdjp

japanfinance-agent

Status: Maintenance mode — This project is stable and functional but not actively developed. Issues and PRs are welcome.

CI PyPI version Python 3.10+ License: Apache-2.0

Compound MCP agent that combines Japan finance data sources into high-value analysis tools. Instead of calling each source individually, get comprehensive company analysis, macro snapshots, and earnings monitoring in a single request.

Part of the Japan Finance Data Stack: edinet-mcp (securities filings) | tdnet-disclosure-mcp (timely disclosures) | estat-mcp (government statistics) | stockprice-mcp (stock prices)

Why?

Each Japan finance MCP provides focused data from one source. But real analysis needs multiple sources combined:

What you want

Without japanfinance-agent

With japanfinance-agent

Company analysis

3 sequential MCP calls (EDINET → TDNET → stock)

analyze 7203

Macro overview

e-Stat search + result aggregation

macro -k GDP

Earnings watchlist

N × TDNET calls for N companies

monitor 7203 6758 6861

Related MCP server: edinet-mcp

Installation

# Core only (brings no data sources)
pip install japanfinance-agent

# With all data sources
pip install "japanfinance-agent[all]"

# Pick specific sources
pip install "japanfinance-agent[edinet,tdnet,news]"

Available extras: edinet, tdnet, estat, stock, all

Configuration

Add to Claude Desktop config:

{
  "mcpServers": {
    "japanfinance": {
      "command": "uvx",
      "args": ["japanfinance-agent[all]", "serve"],
      "env": {
        "EDINET_API_KEY": "your_edinet_key",
        "ESTAT_APP_ID": "your_estat_app_id"
      }
    }
  }
}

Then ask: "トヨタの財務分析をして" or "日本のGDP関連の最新データを見せて"

MCP Tools

Tool

Description

analyze_japanese_company

企業の包括分析(EDINET財務 + TDNET開示 + 株価)

get_macro_snapshot

マクロ経済スナップショット(e-Stat 政府統計)

monitor_earnings

複数企業の決算・開示モニタリング

check_data_sources

データソースの接続状況を確認

CLI Usage

# Analyze a company (EDINET + TDNET + stock)
japanfinance-agent analyze 7203
japanfinance-agent analyze 7203 -e E02144 -p 2025 --json-output

# Macro economic snapshot (e-Stat)
japanfinance-agent macro
japanfinance-agent macro -k CPI

# Monitor earnings for a watchlist
japanfinance-agent monitor 7203 6758 6861

# Check which data sources are available
japanfinance-agent test

# Start MCP server
japanfinance-agent serve

Architecture

japanfinance-agent
├── analyze_company(code)     → EDINET + TDNET + stock (parallel)
├── macro_snapshot(keyword)   → e-Stat government statistics
├── earnings_monitor(codes[]) → TDNET × N companies (parallel)
└── check_data_sources()      → connectivity status

Adapters (graceful degradation — missing packages return empty results):
├── edinet-mcp    → Financial statements, metrics, company search
├── tdnet-mcp     → Timely disclosures (earnings, dividends, buybacks)
├── estat-mcp     → Government statistics (GDP, CPI, employment)
└── stockprice-mcp → Stock prices & FX (via yfinance)

Data Sources

Source

Auth

Data

EDINET

API key (free)

Securities filings, XBRL financial statements

TDNET

None

Timely disclosures (earnings, dividends)

e-Stat

App ID (free)

Government statistics (GDP, CPI, employment)

yfinance

None

Stock prices & market data

License

Apache-2.0

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    A
    maintenance
    Provides programmatic access to Japan's EDINET system to search for listed companies and retrieve annual or quarterly financial reports. It parses XBRL filings into structured data, enabling AI assistants to analyze balance sheets, income statements, and cash flows.
    16
    Apache 2.0
  • A
    license
    -
    quality
    C
    maintenance
    Enables access and analysis of Japanese corporate financial data (PL/BS/CF) via EDINET API. Supports searching companies, listing reports, and comparing financials through natural language queries.
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Lets AI assistants query normalized financial statements (P/L, B/S, C/F) of 3,634 Japanese listed companies from official EDINET filings, unified across J-GAAP, IFRS, and US GAAP with English keys. Zero setup: npx -y edinet-mcp.
    4
    18
    MIT

View all related MCP servers

Related MCP Connectors

  • The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.

  • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

  • Remote MCP for Japan's EDINET DB — 3,800 listed companies' financials & filings (OAuth)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ajtgjmdjp/japanfinance-agent'

If you have feedback or need assistance with the MCP directory API, please join our Discord server