# Torify — Japanese Locale APIs for AI Agents

Torify gives AI agents the Japanese locale primitives that standard libraries lack — imperial era date conversion (wareki), qualified invoice number validation with NTA registry lookup, corporate num…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add endenibrk/torify

# Browse available tools
npx -y smithery tool list endenibrk/torify

# Get full schema for a tool
npx -y smithery tool get endenibrk/torify wareki.convert

# Call a tool
npx -y smithery tool call endenibrk/torify wareki.convert '{}'
```

## Direct MCP Connection

Endpoint: `https://torify.run.tools`

## Tools (10)

- `wareki.convert` — Convert between Japanese era dates (wareki) and Gregorian. Supports Meiji/Taisho/Showa/Heisei/Reiwa. Handles era bounda…
- `invoice.validate` — Validate Japanese qualified invoice number (T-number) format and check digit. T + 13 digits. 日本語: 適格請求書番号フォーマット・チェックデジッ…
- `houjin.lookup` — Look up Japanese corporate number (法人番号, 13 digits) → company name, address, kind, and status via NTA official API. 日本語…
- `postal.lookup` — Japanese postal code (7 digits) → prefecture, city, and town name via zipcloud (no auth required). 日本語: 郵便番号 → 都道府県・市区町…
- `name.romanize` — Hepburn romanize Japanese names (katakana/hiragana) in passport style. Supports family-first and given-first order. 日本語…
- `kanji.toKana` — Convert kanji-containing Japanese text to hiragana or katakana via Yahoo! JLP FuriganaService V2. 日本語: 漢字→かな変換（ひらがな／カタカ…
- `geo.geocode` — Geocode a Japanese address string to latitude/longitude via GSI (国土地理院) AddressSearch API (no auth required). 日本語: 住所 →…
- `geo.reverseGeocode` — Reverse geocode lat/lng to municipality code and town name via GSI (国土地理院) reverse-geocoder API. 日本語: 緯度経度 → 市区町村・町名
- `law.search` — Search Japanese laws by title via e-Gov Hourei API v2 (no auth required). Returns law ID, number, title, and promulgati…
- `invoice.verify` — Verify invoice number registration against NTA public registry API. Returns registrant name, address, and registration …

```bash
# Get full input/output schema for a tool
npx -y smithery tool get endenibrk/torify <tool-name>
```
