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) | boj-mcp (Bank of Japan) | 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

tdnet-disclosure-mcp