Torify — Japan Locale APIs for AI Agents

dev.torify由 torify.dev 发布v0.2.0更新于 Oct 27, 2026

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

已验证Streamable HTTP可网页运行位置与生活开发者工具商业与电商

概览

AI 生成的概览

远程 MCP 服务器，提供日本本地化 API：和历日期、邮编与地址、银行网点、发票与证件校验、文字转换。

可以做什么
  • 在公历与和历之间转换日期，查询节假日与法定假日，计算年龄
  • 查询与规范化日本地址和邮编，进行地理编码与逆地理编码，校验电话号码
  • 检索全银银行与支行数据库，校验转账信息并转换邮储账户
  • 校验发票号、法人番号、税务与法律相关项目，以及个人编号、护照、保险证、车牌、条码等证件格式
  • 姓名罗马字化、拆分与校验，假名与汉字转换，文本规范化
  • 批量执行和历转换、发票校验与税额计算
适用场景
适合助手处理日本商务或行政数据的场景：和历日期、日本地址、银行与支行代码、发票号或法人番号、姓名的假名与罗马字。适用于表单校验、数据清洗和面向日本的后台流程，而非通用网页或编程任务。
运行要求
远程 streamable HTTP 端点，无需本地安装。免费 MCP 档无需密钥或注册，限制为每 IP 每天 100 次请求。更高额度需通过邮件注册、订阅或按次付费获得 X-Trial-Key、X-API-Key 或 X-PAYMENT 请求头。
安装前请注意
付费档会产生费用：通过 X-PAYMENT 请求头以 Base L2 上的 USDC 按次支付 0.02 美元，或每月 49/499 美元订阅。x402 示例要求提供钱包私钥（PRIVATE_KEY），该私钥可授权支出。提交的地址、电话、发票号等标识信息会发送给第三方服务。部分端点（发票登记核验、法人番号查询）标注为等待外部审批。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Torify — Japan Locale APIs for AI Agents，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.torify%2Fjapanese-locale-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源：README.md，提交 9969873

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分