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 keywordlimit: Maximum results (1-100, default: 20)
get_company_disclosures
Get disclosures for a specific company.
Parameters:
code: 4-digit stock codelimit: 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
Tools 4
get_latest_disclosuresGet the most recent TDNET disclosures.search_disclosuresSearch by keyword (company name, stock code, or title).get_company_disclosuresGet disclosures for a specific company.get_disclosures_by_dateGet all disclosures for a specific date.