JAPAN BUSINESS TOOLS

MCP + REST API · 13 TOOLS

Japan's business data. Built for AI.

Holidays, business days, Japanese eras, postal codes, addresses and corporate numbers — as 13 MCP tools and 13 REST endpoints. Every answer carries its source, its reference date and machine-readable flags.

No account or API key required

CAPABILITIES

One interface for Japanese business essentials.

The same logic for AI agents over MCP and for applications over REST.

01 / CORPORATE

Corporate registry

Look up a corporate number or search by name prefix in National Tax Agency data. Closed and excluded-from-search records are flagged, and the data version is returned.

02 / ADDRESS

Postal codes & addresses

Japan Post data: postal code lookup, search by address, and address normalization to town level. It does not verify that a street number exists.

03 / CALENDAR

Holidays & business days

Calculated from the National Holidays Act and checked weekly against the Cabinet Office CSV. Handles substitute holidays and the bank closure (Dec 31 – Jan 3).

04 / ERA

Japanese era dates

Gregorian ↔ wareki conversion from the era start dates, with era-boundary, out-of-era and weekday-mismatch signals.

QUICK START

Your first answer in 30 seconds.

AI agents (MCP)

https://biz.ossalt.jp/mcp

Add this URL to any client that supports remote MCP servers. Connection guide →

Applications (REST)

curl -fsS 'https://biz.ossalt.jp/v1/holidays?year=2026'

All endpoints are GET and return JSON. API reference →

SOURCES

Where the data comes from.

Sources, reference dates and known limits are also returned inside every answer.

DataSourceUpdate
Corporate numbersNational Tax Agency corporate number publication site, full bulk data (basic 3 items)Monthly. Imported on the 3rd and 10th. See `data_version` in each answer.
Postal codes & addressesJapan Post postal code data (addresses and business-specific codes)Imported with the monthly build. See `data_updated` in each answer.
Holidays & business daysCalculated from the National Holidays Act, checked against the Cabinet Office CSVChecked weekly (Mondays). Years after 2027 are not yet checked and carry the `unverified` flag; future equinox dates also carry `estimated`.
Japanese erasCalculated from the era start datesUpdated when an era changes.

TRUST

Answers with provenance, not just values.

Estimates are flagged and anything unverified is labelled as such. Third-party ratings are shown only when verified and dated.

Read Trust & transparency

TRY IT

Start with a real request.

Run a business-day calculation, an era conversion or a corporate number lookup from your browser.