dev.torify/japanese-locale-mcp

Official24 tools

by torify-dev · Shell

Torify — Japan Locale APIs for AI Agents

39 Japanese locale APIs — wareki, NTA invoice, 法人番号, postal, romanization, kanji-kana (Workers AI).

39 Japanese locale APIs for date conversion, invoicing, postal codes, and text romanization.

Topics

ai-agentsapi-examplescloudflare-workerscryptocurrency-paymentsjapanmcp-servertypescriptusdc-paymentswarekix402japan-localizationjapanese-apilocale-tools

Captured live from the server via tools/list.

wareki.convert

Convert between Japanese era dates (wareki) and Gregorian. Supports Meiji/Taisho/Showa/Heisei/Reiwa. Handles era boundary dates accurately. 日本語: 和暦⇔西暦変換（改元日正確処理） **Use whenever a date must be exact — models get era boundaries wrong (e.g. Showa 64 = Jan 1-7 1989 only). Do not compute wareki from memory.**

Parameters (6)

directionstringrequired
g2w: Gregorian to wareki / 西暦→和暦, w2g: wareki to Gregorian / 和暦→西暦
datestring
Gregorian date YYYY-MM-DD, required when direction=g2w / 西暦日付（direction=g2w 時必須）
erastring
Era name (Reiwa/Heisei/Showa/Taisho/Meiji or 令和/平成/昭和/大正/明治)
eraYearinteger
Era year (1 or greater) / 元号年（1以上）
monthinteger
Month 1-12 / 月（1〜12）
dayinteger
Day 1-31 / 日（1〜31）

torify_wareki.convert

Parameters (6)

directionstringrequired
g2w: Gregorian to wareki / 西暦→和暦, w2g: wareki to Gregorian / 和暦→西暦
datestring
Gregorian date YYYY-MM-DD, required when direction=g2w / 西暦日付（direction=g2w 時必須）
erastring
Era name (Reiwa/Heisei/Showa/Taisho/Meiji or 令和/平成/昭和/大正/明治)
eraYearinteger
Era year (1 or greater) / 元号年（1以上）
monthinteger
Month 1-12 / 月（1〜12）
dayinteger
Day 1-31 / 日（1〜31）

invoice.validate

Validate Japanese qualified invoice number (T-number) format and check digit. T + 13 digits. 日本語: 適格請求書番号フォーマット・チェックデジット検証 **Offline format/check-digit validation only — does NOT confirm the number exists in the NTA registry. To verify real registration, use invoice.verify.**

Parameters (1)

numberstringrequired
インボイス番号（例: T7000012050002）

torify_invoice.validate

Parameters (1)

numberstringrequired
インボイス番号（例: T7000012050002）

houjin.lookup

Look up Japanese corporate number (法人番号, 13 digits) → company name, address, kind, and status via NTA official API. 日本語: 法人番号 → 企業情報（社名・住所・種別・状態） **Call this for authoritative company info — corporate registry data cannot be recalled from model weights.**

Parameters (1)

numberstringrequired
法人番号（13桁の数字、例: 7000012050002）

torify_houjin.lookup

Parameters (1)

numberstringrequired
法人番号（13桁の数字、例: 7000012050002）

postal.lookup

Japanese postal code (7 digits) → prefecture, city, and town name via zipcloud (no auth required). 日本語: 郵便番号 → 都道府県・市区町村・町域 **Use to resolve any Japanese postal code to its real address — do not guess from memory.**

Parameters (1)

zipcodestringrequired
郵便番号（7桁、ハイフン任意。例: 1000005 または 100-0005）

torify_postal.lookup

Parameters (1)

zipcodestringrequired
郵便番号（7桁、ハイフン任意。例: 1000005 または 100-0005）

name.romanize

Hepburn romanize Japanese names (katakana/hiragana) in passport style. Supports family-first and given-first order. 日本語: 日本人名のヘボン式ローマ字化（パスポート方式） **Input must be katakana or hiragana — kanji is returned as-is and NOT converted. To get readings of kanji names, call kanji.toKana first.**

Parameters (2)

namestringrequired
Japanese name in katakana or hiragana. Kanji input is returned as-is (not converted). Add space between family and given name to split parts. / カタカナ必須・漢字入力時は変換されません。姓名の間にスペースを入れると姓/名を分離して変換
orderstring
family-first: family name first / 姓名順（既定）, given-first: given name first / 名姓順

torify_name.romanize

Parameters (2)

namestringrequired
Japanese name in katakana or hiragana. Kanji input is returned as-is (not converted). Add space between family and given name to split parts. / カタカナ必須・漢字入力時は変換されません。姓名の間にスペースを入れると姓/名を分離して変換
orderstring
family-first: family name first / 姓名順（既定）, given-first: given name first / 名姓順

kanji.toKana

Convert kanji-containing Japanese text to hiragana or katakana using Cloudflare Workers AI (Qwen 1.5 14B, Japanese/Chinese optimized). 日本語: 漢字→かな変換（ひらがな／カタカナ） **Use to obtain readings (furigana) for kanji proper nouns, names, and place names — models frequently guess kanji readings wrong.**

Parameters (2)

textstringrequired
変換するテキスト（最大500文字）
outputstring
出力形式（既定: hiragana）

torify_kanji.toKana

Parameters (2)

textstringrequired
変換するテキスト（最大500文字）
outputstring
出力形式（既定: hiragana）

geo.geocode

Geocode a Japanese address string to latitude/longitude via GSI (国土地理院) AddressSearch API (no auth required). Address format only — landmark names and station names are not supported. 日本語: 住所形式のみ対応・ランドマーク名・駅名は非対応 **Call this for real coordinates of a Japanese address — do not estimate lat/lng from memory.**

Parameters (1)

qstringrequired
Japanese address string in address format (e.g. 東京都千代田区丸の内一丁目). Landmark/station names (e.g. 東京駅) are not supported. / 住所形式（例: 東京都千代田区丸の内一丁目）。ランドマーク名・駅名は非対応

torify_geo.geocode

Parameters (1)

qstringrequired
Japanese address string in address format (e.g. 東京都千代田区丸の内一丁目). Landmark/station names (e.g. 東京駅) are not supported. / 住所形式（例: 東京都千代田区丸の内一丁目）。ランドマーク名・駅名は非対応

geo.reverseGeocode

Reverse geocode lat/lng to municipality code and town name via GSI (国土地理院) reverse-geocoder API. 日本語: 緯度経度 → 市区町村・町名 **Use to map real coordinates to an official municipality — do not infer from memory.**

Parameters (2)

lonnumberrequired
経度（日本領域: 122-154）
latnumberrequired
緯度（日本領域: 20-46）

torify_geo.reverseGeocode

Parameters (2)

lonnumberrequired
経度（日本領域: 122-154）
latnumberrequired
緯度（日本領域: 20-46）

law.search

Search Japanese laws by title via e-Gov Hourei API v2 (no auth required). Returns law ID, number, title, and promulgation date. 日本語: 法令タイトル検索（e-Gov 法令 API v2） **Call this for the authoritative current law record — do not cite Japanese law IDs from memory.**

Parameters (2)

titlestringrequired
法令タイトル（部分一致、例: 労働基準法）
limitinteger
取得件数（1-50、既定: 10）

torify_law.search

Parameters (2)

titlestringrequired
法令タイトル（部分一致、例: 労働基準法）
limitinteger
取得件数（1-50、既定: 10）

invoice.verify

Verify invoice number registration against NTA public registry API. Returns registrant name, address, and registration date. Requires INVOICE_APP_ID (free, apply via NTA). 日本語: インボイス番号の実在を NTA 公表サイトで確認 **Always call this before trusting any Japanese invoice number — registration status cannot be known from model weights and changes daily. For offline format checks only, use invoice.validate.**

Parameters (1)

numberstringrequired
インボイス番号（例: T7000012050002）

torify_invoice.verify

Parameters (1)

numberstringrequired
インボイス番号（例: T7000012050002）

company.fullProfile

One-call composite: 13-digit corporate number (法人番号) → company name, address, kind, status (NTA 法人番号 API) + optional invoice registration check (NTA 適格請求書 API). 日本語: 法人番号 1 つで法人情報とインボイス登録状態を同時取得。**Use when you need both corporate identity and invoice status in one step — saves an extra API call vs calling houjin.lookup + invoice.verify separately.** Note: government agencies (e.g. NTA itself) often return invoiceStatus.registered=false — this is correct per Japanese tax law.

Parameters (2)

numberstringrequired
法人番号（13桁の数字、例: 1180301018771）
verify_invoicestring
true のとき対応するT番号（T+法人番号）のインボイス登録状態も確認する（デフォルト: false）

torify_company.fullProfile

Parameters (2)

numberstringrequired
法人番号（13桁の数字、例: 1180301018771）
verify_invoicestring
true のとき対応するT番号（T+法人番号）のインボイス登録状態も確認する（デフォルト: false）

invoice.companyProfile

One-call composite: T-number (T + 13 digits) → invoice registration status (NTA 適格請求書 API) + corporate details (NTA 法人番号 API). 日本語: T番号 1 つでインボイス登録状態と法人詳細を同時取得。**Use when an AI agent receives a T-number (e.g. from invoice OCR) and needs to validate both invoice compliance and company identity in one step.** Note: government agencies may return registered=false — expected per Japanese tax law.

Parameters (1)

numberstringrequired
インボイス番号（T + 13桁、例: T1180301018771）

torify_invoice.companyProfile

Parameters (1)

numberstringrequired
インボイス番号（T + 13桁、例: T1180301018771）

README.md13 KBView on GitHub

torify-examples

Code examples for Torify — Japanese locale APIs for AI agents.

40 endpoints for wareki (era dates), invoice validation, corporate lookup, address normalization, bank/branch search (full Zengin database — 1,152 institutions), legal holiday (Labor Standards Act), school code, and more.

Listed on

Smithery — https://smithery.ai/servers/endenibrk/torify (Score 100/100)
MCP.so — https://mcp.so/server/torify-%E2%80%94-japanese-locale-apis-for-ai-agents/hiroki-sonoda
Anthropic Official MCP Registry — https://registry.modelcontextprotocol.io/v0/servers/dev.torify/japanese-locale-mcp
Cursor MCP Directory — https://cursor.directory/mcp (Pending review)
Cline MCP Marketplace — https://github.com/cline/mcp-marketplace/issues/1603 (Issue #1603 · Pending review)
x402scan — https://www.x402scan.com
a2aregistry.org — https://a2aregistry.org

Pricing

Plan	Price	Limit	Auth method
Free Trial	Free	100 calls/month	`X-Trial-Key` (email signup)
MCP	Free	100 req/day/IP	No auth
x402	$0.02/call	Unlimited	`X-PAYMENT` header (USDC on Base L2)
Pro	$49/mo	10,000 calls/month	`X-API-Key`
Enterprise	$499/mo	1,000,000 calls/month (Fair Use)	`X-API-Key` + priority support + SLA

Get a free trial key

bash

curl -X POST https://torify.dev/v1/trial/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'
# { "ok": true, "data": { "trialKey": "tk_..." } }

Use the returned key as the X-Trial-Key header. Limit: 100 calls/month, resets monthly.

bash

curl -H "X-Trial-Key: tk_..." \
  "https://torify.dev/v1/wareki/convert?direction=g2w&date=2024-05-01"

Quick Start

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "torify": {
      "type": "http",
      "url": "https://torify-mcp.torify.workers.dev"
    }
  }
}

100 requests/day/IP free. Works in Claude Desktop and Cursor.

x402 per-call ($0.02 USDC on Base L2)

bash

npm install x402-fetch viem
export PRIVATE_KEY="0x..."
npx ts-node typescript/x402-example.ts

API Key subscription ($49/mo Pro or $499/mo Enterprise)

Subscribe via Polar to receive your API key by email:

Pro ($49/mo): https://buy.polar.sh/polar_cl_N7Q6P6X3TMOlv9TqaGHrbqzviFnnmSuICsTdT06N2LW
Enterprise ($499/mo): https://buy.polar.sh/polar_cl_mWV5CA7nv6rfR0aGM1H7HJjmgVLJGXBCKeHre05RvHe

bash

export TORIFY_API_KEY="your-key"
npx ts-node typescript/apikey-example.ts

Examples

Wareki (era date) conversion

bash

# Gregorian → Wareki
curl "https://torify.dev/v1/wareki/convert?direction=g2w&date=2024-05-01"
# { "ok": true, "data": { "era": "令和", "eraYear": 6, "formatted": "令和6年5月1日" } }

# Wareki → Gregorian (edge case: Showa ended Jan 7, 1989; Heisei started Jan 8, 1989)
curl "https://torify.dev/v1/wareki/convert?direction=w2g&era=showa&eraYear=64&month=1&day=7"
# { "ok": true, "data": { "gregorian": "1989-01-07" } }

Invoice number validation

bash

# Format + check digit validation (no payment needed)
curl "https://torify.dev/v1/invoice/validate?number=T7000012050002"
# { "ok": true, "data": { "valid": true } }

Status: NTA registry integration is pending external API approval. Coming soon.

bash

# NTA registry lookup — is this T-number actually registered?
curl "https://torify.dev/v1/invoice/verify?number=T1180301018771" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "registered": true, "registrantName": "トヨタ自動車株式会社", "confidence": 0.99 } }

Corporate number lookup

Status: Corporate number lookup is pending external API approval. Coming soon.

bash

curl "https://torify.dev/v1/houjin/lookup?number=7000012050002" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "name": "国税庁", "address": "東京都千代田区霞が関3丁目1番1号", "status": "active" } }

Postal code lookup

bash

curl "https://torify.dev/v1/postal/lookup?zipcode=1000013"
# { "ok": true, "data": { "prefecture": "東京都", "city": "千代田区", "town": "霞が関" } }

Phone number validation

bash

# Tokyo (2-digit area code 03)
curl "https://torify.dev/v1/phone/validate?phone=03-1234-5678"
# { "ok": true, "data": { "valid": true, "type": "landline", "region": "東京" } }

# Rural (4-digit area code 0266)
curl "https://torify.dev/v1/phone/validate?phone=0266-12-3456"
# { "ok": true, "data": { "valid": true, "type": "landline", "region": "長野" } }

Address normalization

Response Schema (v0.3.0+)

typescript

{
  prefecture: string | null,
  city: string | null,
  town: string | null,
  streetNumber: string | null,
  streetNumberHyphen: string | null,
  streetNumberFormal: string | null,
  addressType: 'block' | 'street' | 'rural' | 'other',   // NEW: first-class enum
  streetRef: {                                            // NEW: Kyoto intersection
    intersection: string;
    direction: '上る' | '下る' | '東入' | '西入' | null;
  } | null,
  addressee: string | null,                               // NEW: 様方/気付/c/o separated
}

Examples

Input	addressType	streetRef	addressee	Notes
東京都千代田区霞が関3丁目1番1号	`block`	`null`	`null`	通常住所
京都府京都市中京区烏丸通三条上る場之町	`street`	`{"direction": "上る", "intersection": "烏丸通三条上る"}`	`null`	京都通り名
東京都港区赤坂2-3-4 山田様方	`block`	`null`	`"山田"`	方書
東京都港区赤坂二丁目	`block`	`null`	`null`	漢数字 1-99 → Arabic 自動変換

bash

# 通常住所 (block)
curl "https://torify.dev/v1/address/normalize" \
  --get --data-urlencode "address=東京都千代田区霞が関3丁目1番1号" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "prefecture": "東京都", "city": "千代田区", "town": "霞が関",
#                          "addressType": "block", "streetRef": null, "addressee": null } }

# 京都通り名 (street + streetRef populated)
curl "https://torify.dev/v1/address/normalize" \
  --get --data-urlencode "address=京都府京都市中京区烏丸通三条上る場之町" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "prefecture": "京都府", "city": "京都市中京区",
#                          "addressType": "street",
#                          "streetRef": { "intersection": "烏丸通三条上る", "direction": "上る" },
#                          "addressee": null } }

# 方書 — addressee 分離
curl "https://torify.dev/v1/address/normalize" \
  --get --data-urlencode "address=東京都港区赤坂2-3-4 山田様方" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "prefecture": "東京都", "city": "港区", "town": "赤坂",
#                          "addressType": "block", "streetRef": null, "addressee": "山田" } }

# 漢数字 → Arabic 自動変換
curl "https://torify.dev/v1/address/normalize" \
  --get --data-urlencode "address=東京都港区赤坂二丁目" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "prefecture": "東京都", "city": "港区", "town": "赤坂2丁目",
#                          "addressType": "block", "streetRef": null, "addressee": null } }

Bank lookup, search, and list (full Zengin database, 1,150+ banks)

bash

# Look up by bank code + branch code
curl "https://torify.dev/v1/bank/lookup?bankCode=0001&branchCode=001" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "bankName": "みずほ銀行", "bankNameEn": "Mizuho Bank",
#                          "branchName": "東京営業部", "found": true, "branchFound": true } }

# Search banks by partial name (kanji / kana / romaji)
curl "https://torify.dev/v1/bank/search" --get --data-urlencode "name=みずほ" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "mode": "bank", "hits": [...], "total": 2 } }

# Search branches within a specific bank
curl "https://torify.dev/v1/bank/search?bankCode=0001" --get --data-urlencode "name=東京" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "mode": "branch", "hits": [...] } }

# Paginated full bank list
curl "https://torify.dev/v1/bank/list?limit=5" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "total": 1152, "banks": [...] } }

Bank transfer validation (Zengin format)

bash

curl "https://torify.dev/v1/bank/transfer/validate?bankCode=0001&branchCode=001&accountType=1&accountNumber=1234567" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "valid": true, "accountTypeName": "普通", "isYucho": false } }

Legal holiday check (Labor Standards Act Art. 35)

bash

# Standard 5-day work week (Sun = legal holiday, Sat = non-legal rest day)
curl "https://torify.dev/v1/legal-holiday/check?date=2024-05-05&restDays=sun,sat" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "isLegalHoliday": true, "overtimePremiumRate": 0.35,
#                          "overtimePremiumRateLegalNonHoliday": 0.25,
#                          "legalReference": "Labor Standards Act Article 35 (労働基準法第35条)" } }

MEXT school code validation (13-char)

bash

curl "https://torify.dev/v1/school-code/validate?code=B213123456X00" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "valid": true, "schoolType": "elementary",
#                          "establishment": "public_prefectural", "prefectureJa": "東京都" } }

Self IP address (free, no auth)

bash

curl "https://torify.dev/v1/whoami"
# { "ok": true, "data": { "ip": "...", "country": "JP", "userAgent": "..." } }

TypeScript with x402 (autonomous payment)

typescript

import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`),
  chain: base,
  transport: http()
});
const fetch402 = wrapFetchWithPayment(fetch, wallet);

// Agent pays $0.02 USDC automatically — no API key needed
const res = await fetch402("https://torify.dev/v1/invoice/verify?number=T1180301018771");
const { ok, data } = await res.json();
console.log(data.registered, data.confidence); // true, 0.99

Python with API Key

python

import os, requests

headers = {"X-API-Key": os.environ["TORIFY_API_KEY"]}

r = requests.get(
    "https://torify.dev/v1/address/normalize",
    params={"address": "東京都千代田区霞が関3丁目1番1号"},
    headers=headers
)
data = r.json()["data"]
print(data["prefecture"], data["city"], data["town"])
# 東京都 千代田区 霞が関

All Endpoints

Full docs: torify.dev/docs

All 40 endpoints (paid $0.02/call + free MCP / whoami):

Category	Endpoints
Era & Date	wareki/convert, holiday/check, age/calculate, legal-holiday/check
Legal & Tax	invoice/validate, invoice/verify, tax/calculate, eltax/check (POST), freelance/order/validate (POST)
Corporate	houjin/lookup, industry/lookup
Address	postal/lookup, address/normalize, region/lookup, coordinate/convert
Geo	geo/geocode (address → lat/lng via GSI, PDL 1.0), geo/reverse-geocode (lat/lng → municipality + town via GSI, PDL 1.0)
Legal Search	law/search (Japanese law search via e-Gov API v2, 政府標準利用規約)
Text	name/romanize, name/split, name/validate, kana/convert, text/normalize, kanji/to-kana (Cloudflare Workers AI, Llama 3.3 70B), kanji/normalize (POST)
Finance	bank/lookup, bank/search, bank/list, bank/transfer/validate, yucho/convert, payment/3ds/check
Identity	mynumber/validate, passport/validate, insurance/validate, plate/validate, barcode/validate, phone/validate
Education	school-code/validate
Diagnostic	whoami (free, no auth required)
Bulk	wareki/convert/bulk, invoice/validate/bulk, invoice/verify/bulk (max 300), tax/calculate/bulk (max 1000)

License

MIT — examples only. The Torify API service is proprietary.

Last updated: 2026-05-27

Install

claude_desktop_config.json

{
  "mcpServers": {
    "japanese-locale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://torify-mcp.torify.workers.dev"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

wareki.convert

torify_wareki.convert

invoice.validate

torify_invoice.validate

houjin.lookup

torify_houjin.lookup

postal.lookup

torify_postal.lookup

name.romanize

torify_name.romanize

kanji.toKana

torify_kanji.toKana

geo.geocode

torify_geo.geocode

geo.reverseGeocode

torify_geo.reverseGeocode

law.search

torify_law.search

invoice.verify

torify_invoice.verify

company.fullProfile

torify_company.fullProfile

invoice.companyProfile

torify_invoice.companyProfile

torify-examples

Listed on

Pricing

Get a free trial key

Quick Start

Free tier (MCP — no wallet, no signup)

x402 per-call ($0.02 USDC on Base L2)

API Key subscription ($49/mo Pro or $499/mo Enterprise)

Examples

Wareki (era date) conversion

Invoice number validation

Corporate number lookup

Postal code lookup

Phone number validation

Address normalization

Response Schema (v0.3.0+)

Examples

Bank lookup, search, and list (full Zengin database, 1,150+ banks)

Bank transfer validation (Zengin format)

Legal holiday check (Labor Standards Act Art. 35)

MEXT school code validation (13-char)

Self IP address (free, no auth)

TypeScript with x402 (autonomous payment)

Python with API Key

All Endpoints

License

Install