Torify — Japan Locale APIs for AI Agents

dev.torifyPublished by torify.devv0.2.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server exposing Japanese locale APIs: era dates, postal and address handling, bank codes, invoice and ID validation, and text conversion.

What you can do
  • Convert dates between Gregorian and Japanese era formats, check holidays and legal holidays, and calculate age
  • Look up and normalize Japanese addresses and postal codes, geocode and reverse-geocode, and validate phone numbers
  • Search the Zengin bank and branch database, validate transfer details and Yucho account conversion
  • Validate invoice numbers, corporate numbers, tax and legal checks, and identity formats such as My Number, passport, insurance card, license plate and barcode
  • Romanize, split and validate names, convert kana and kanji, and normalize text
  • Run bulk versions of era conversion, invoice validation and tax calculation
When to use it
Useful when an assistant has to handle Japanese business or administrative data: era dates, Japanese addresses, bank and branch codes, invoice or corporate numbers, or kana and romanization of names. It suits form validation, data cleanup and Japan-focused back-office workflows rather than general web or code tasks.
Requirements
A remote streamable HTTP endpoint; no local install. The free MCP tier needs no key or signup and is limited to 100 requests per day per IP. Higher limits need an X-Trial-Key, X-API-Key or X-PAYMENT header, obtained by email signup, subscription or per-call payment.
Before you install
Paid tiers cost money: $0.02 per call via the X-PAYMENT header in USDC on Base L2, or $49/$499 monthly subscriptions. The x402 example asks for a wallet private key in PRIVATE_KEY, which grants spending authority. Addresses, phone numbers, invoice numbers and other identifiers you submit are sent to a third-party service. Some endpoints (invoice registry verification, corporate number lookup) are marked as pending external approval.

Installation

In SourceWeft

  1. Open Torify — Japan Locale APIs for AI Agents in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.torify%2Fjapanese-locale-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "torify-japan-locale-apis-for-ai-agents": {
      "type": "http",
      "url": "https://torify-mcp.torify.workers.dev/"
    }
  }
}

README

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.

[torify.dev] [License: MIT] [Smithery] [MCP.so] [Anthropic Registry]

Listed on

Pricing

PlanPriceLimitAuth method
Free TrialFree100 calls/monthX-Trial-Key (email signup)
MCPFree100 req/day/IPNo auth
x402$0.02/callUnlimitedX-PAYMENT header (USDC on Base L2)
Pro$49/mo10,000 calls/monthX-API-Key
Enterprise$499/mo1,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":"[email protected]"}'# { "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

Free tier (MCP — no wallet, no signup)

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 viemexport 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:

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

Examples

Wareki (era date) conversion

bash
# Gregorian → Warekicurl "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
InputaddressTypestreetRefaddresseeNotes
東京都千代田区霞が関3丁目1番1号blocknullnull通常住所
京都府京都市中京区烏丸通三条上る場之町street{"direction": "上る", "intersection": "烏丸通三条上る"}null京都通り名
東京都港区赤坂2-3-4 山田様方blocknull"山田"方書
東京都港区赤坂二丁目blocknullnull漢数字 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 codecurl "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 bankcurl "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 listcurl "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 neededconst 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):

CategoryEndpoints
Era & Datewareki/convert, holiday/check, age/calculate, legal-holiday/check
Legal & Taxinvoice/validate, invoice/verify, tax/calculate, eltax/check (POST), freelance/order/validate (POST)
Corporatehoujin/lookup, industry/lookup
Addresspostal/lookup, address/normalize, region/lookup, coordinate/convert
Geogeo/geocode (address → lat/lng via GSI, PDL 1.0), geo/reverse-geocode (lat/lng → municipality + town via GSI, PDL 1.0)
Legal Searchlaw/search (Japanese law search via e-Gov API v2, 政府標準利用規約)
Textname/romanize, name/split, name/validate, kana/convert, text/normalize, kanji/to-kana (Cloudflare Workers AI, Llama 3.3 70B), kanji/normalize (POST)
Financebank/lookup, bank/search, bank/list, bank/transfer/validate, yucho/convert, payment/3ds/check
Identitymynumber/validate, passport/validate, insurance/validate, plate/validate, barcode/validate, phone/validate
Educationschool-code/validate
Diagnosticwhoami (free, no auth required)
Bulkwareki/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

Source: README.md at commit 9969873

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts