tdnet-disclosure-mcp

CI PyPI version Python 3.10+ License: Apache-2.0

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

Project links

Data verified by PyPI on Aug 23, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ajtgjmdjp from gravatar.com ajtgjmdjp

GitHub Statistics

Data verified by PyPI on Aug 23, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

disclosure japan jpx mcp tdnet timely-disclosure

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tdnet_disclosure_mcp-0.2.1.tar.gz (133.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tdnet_disclosure_mcp-0.2.1-py3-none-any.whl (16.5 kB view details)

Uploaded Python 3

File details

Details for the file tdnet_disclosure_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: tdnet_disclosure_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 133.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tdnet_disclosure_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 62a0ba6c79aa88f60b47ed7c2594fe84a54b61a9c23a5076ca57c131be0e4d95
MD5 7d6e0dfe0b9e379e6b4c1b107686718e
BLAKE2b-256 627ae49545d91acdedac58b7d39234d8b67651681491f0e1a10247a400c668d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for tdnet_disclosure_mcp-0.2.1.tar.gz:

Publisher: publish.yml on ajtgjmdjp/tdnet-disclosure-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tdnet_disclosure_mcp-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for tdnet_disclosure_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fb508baadcd3678f1e91b75db84b4be87edaa3b2e7c3c6db8080dfd8aa094685
MD5 b885e2264d594d6564749d4d29bba7a2
BLAKE2b-256 41fc1e6b6502932cf8d494813afce4db6d08a92fb60379132059fe441a26f9e8

See more details on using hashes here.

Provenance

The following attestation bundles were made for tdnet_disclosure_mcp-0.2.1-py3-none-any.whl:

Publisher: publish.yml on ajtgjmdjp/tdnet-disclosure-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page