# Torify — Japanese Locale APIs for AI Agents

Torify — Japanese Locale APIs for AI Agents is an MCP server for Claude Code that handles Japanese era dates, invoice numbers, company lookups and postal codes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 815 installs
- Author: endenibrk
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/endenibrk/torify
- Updated: 2026-05-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/torify-japanese-locale-apis-for-ai-agents

## What it does

Standard libraries stop where the Japanese locale starts. `wareki.convert` maps dates between the Meiji, Taisho, Showa, Heisei and Reiwa eras and the Gregorian calendar, including the days eras changed. `invoice.validate` checks a T-number's format and check digit. `houjin.lookup` takes a 13-digit corporate number and returns the company name, address, kind and status from the NTA API.

Several tools need no key at all. `postal.lookup` turns a 7-digit postal code into prefecture, city and town through zipcloud. `geo.reverseGeocode` gives a municipality code and town name for a coordinate pair. `law.search` finds a law by title in the e-Gov Hourei API v2. `name.romanize` writes names in Hepburn romanization, passport style, either family name first or given name first, while `kanji.toKana` outputs hiragana or katakana using Cloudflare Workers AI.

Two tools have edges worth knowing. `invoice.verify` checks a number against the NTA registry and needs `INVOICE_APP_ID`, which NTA issues free on application. `geo.geocode` accepts address strings only, so a station or landmark name comes back empty. The MCP endpoint asks for no authentication; email signup brings 100 calls a month, then $0.02 per call over x402 or a $49 monthly Pro plan.

## Requirements
- Remote server: `https://torify.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http torify https://torify.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add torify-japanese-locale-apis-for-ai-agents --url https://torify.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "torify-japanese-locale-apis-for-ai-agents": {
            "url": "https://torify.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "torify-japanese-locale-apis-for-ai-agents": {
            "type": "http",
            "url": "https://torify.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http torify-japanese-locale-apis-for-ai-agents https://torify.run.tools
```

## When to use it
- convert an era date across a change-of-era boundary
- check a T-number check digit before issuing an invoice
- resolve a 13-digit corporate number to a company record
- turn a postal code into prefecture and town
- romanize a name for a passport-style document

## Example prompts
- Convert the contract date to the Japanese era with `wareki.convert`.
- Look up the corporate number on this invoice with `houjin.lookup` and give me the registered name and address.
- Romanize the applicant's name in passport style with `name.romanize`, family name first.

## Similar
- [PlugRail Japanese Calendar](https://affpapa.org/en/nevibecode/mcp/plugrail-japanese-calendar.md) — MCP server
- [web-search-plus](https://affpapa.org/en/nevibecode/skills/web-search-plus.md) — skill · 1200 installs
- [building-apis](https://affpapa.org/en/nevibecode/skills/building-apis.md) — skill · 4000 installs
- [awesome-free-llm-apis](https://affpapa.org/en/nevibecode/skills/awesome-free-llm-apis.md) — skill · 1000 installs
- [mcp-brasil-public-apis](https://affpapa.org/en/nevibecode/skills/mcp-brasil-public-apis.md) — skill · 880 installs
- [translation-expertise](https://affpapa.org/en/nevibecode/skills/translation-expertise.md) — skill · 675 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
