ajtgjmdjp/tdnet-disclosure-mcp

6 stars 4 forks Quality 77 Trend 22Apache-2.0

MCP server for TDNET timely disclosures (適時開示) — earnings, dividends, M&A, buybacks from Tokyo Stock Exchange

Overview

Model Context Protocol (MCP) server for from the Tokyo Stock Exchange (JPX/TSE). Access earnings reports (決算短信), dividend announcements, buyback disclosures, forecast revisions, and more — no API key required. Part of the Japan Finance Data Stack: edinet-mcp (securities filings) | (timely disclosures) | estat-mcp (government statistics) | stockprice-mcp (stock prices & FX) - : get_latest_disclosures, search_disclosures, get_company_disclosures, get_disclosures_by_date - - uses free public API - : earnings (決算短信), dividends, forecast revisions, buybacks, governance - : latest, search, company, by-date, test, serve No API key required. Add to Claude Desktop config: Parameters: - limit: Maximum results (1-300, default: 50) Search by keyword (company name, stock code, or title). Parameters: - keyword: Search keyword - limit: Maximum results (1-100, default: 20) Parameters: - code: 4-digit stock code - limit: Maximum results (1-300, default: 50)

README

tdnet-disclosure-mcp

Model Context Protocol (MCP) server for TDNET timely disclosures (適時開示) from the Tokyo Stock Exchange (JPX/TSE). Access earnings reports (決算短信), dividend announcements, buyback disclosures, forecast revisions, and more — no API key required.

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

Features

4 MCP Tools: get_latest_disclosures, search_disclosures, get_company_disclosures, get_disclosures_by_date
No authentication required - uses free public API
Auto-categorization: earnings (決算短信), dividends, forecast revisions, buybacks, governance
CLI: latest, search, company, by-date, test, serve

Installation

pip install tdnet-disclosure-mcp

Configuration

No API key required. Add to Claude Desktop config:

{
  "mcpServers": {
    "tdnet": {
      "command": "uvx",
      "args": ["tdnet-disclosure-mcp", "serve"]
    }
  }
}

CLI Usage

# Get latest disclosures
tdnet-disclosure-mcp latest
tdnet-disclosure-mcp latest --limit 50

# Search disclosures
tdnet-disclosure-mcp search "トヨタ"
tdnet-disclosure-mcp search "決算短信"

# Get company disclosures
tdnet-disclosure-mcp company 7203

# Get disclosures by date
tdnet-disclosure-mcp by-date 2026-02-14

# Test API connection
tdnet-disclosure-mcp test

# Start MCP server
tdnet-disclosure-mcp serve

MCP Tools

get_latest_disclosures

Get the most recent TDNET disclosures.

Parameters:

limit: Maximum results (1-300, default: 50)

search_disclosures

Search by keyword (company name, stock code, or title).

Parameters:

keyword: Search keyword
limit: Maximum results (1-100, default: 20)

get_company_disclosures

Get disclosures for a specific company.

Parameters:

code: 4-digit stock code
limit: Maximum results (1-300, default: 50)

get_disclosures_by_date

Get all disclosures for a specific date.

Parameters:

target_date: Date in YYYY-MM-DD format

Disclosure Categories

Category	Japanese	Examples
earnings	決算短信	Quarterly/annual earnings reports
dividend	配当	Dividend changes
forecast_revision	業績予想修正	Earnings forecast revisions
buyback	自社株買い	Share buyback announcements
offering	増資/新株	Stock offerings
governance	ガバナンス	Corporate governance, board changes
other	その他	Other disclosures

Data Attribution & Disclaimer

Data provided by Yanoshin Web API. Not affiliated with JPX/TSE or Yanoshin. Verify against official TDNET sources.

License

Apache-2.0

View the full README on GitHub

Install

uvx tdnet-disclosure-mcp serve

New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "tdnet": {
      "command": "uvx",
      "args": ["tdnet-disclosure-mcp", "serve"]
    }
  }
}