Skip to main content
Glama
torify-dev

Torify — Japanese Locale APIs for AI Agents

by torify-dev

torify-examples

Torify — AI 에이전트를 위한 일본 로케일 API의 코드 예제입니다.

와레키(연호), 청구서 검증, 법인 조회, 주소 정규화 등을 위한 31개의 엔드포인트를 제공합니다.

torify.dev License: MIT


빠른 시작

무료 티어 (MCP — 지갑 및 가입 불필요)

claude_desktop_config.json에 추가하세요:

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

IP당 하루 100회 요청 무료. Claude Desktop 및 Cursor에서 작동합니다.

x402 호출당 요금 (Base L2에서 $0.02 USDC)

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

API 키 구독 (월 $49)

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

Related MCP server: japan-ux-mcp

예제

와레키(연호) 변환

# 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" } }

청구서 번호 검증

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

상태: NTA 레지스트리 연동은 외부 API 승인 대기 중입니다. 곧 제공될 예정입니다.

# NTA registry lookup — is this T-number actually registered?
curl "https://torify.dev/v1/invoice/verify?number=T8010401050783" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "registered": true, "registrantName": "国税庁", "confidence": 0.99 } }

법인 번호 조회

상태: 법인 번호 조회는 외부 API 승인 대기 중입니다. 곧 제공될 예정입니다.

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

우편번호 조회

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

전화번호 검증

# 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": "長野" } }

주소 정규화

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": "霞が関", "block": "3丁目1番1号" } }

x402를 사용한 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=T8010401050783");
const { ok, data } = await res.json();
console.log(data.registered, data.confidence); // true, 0.99

API 키를 사용한 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"])
# 東京都 千代田区 霞が関

전체 엔드포인트

전체 문서: torify.dev/docs

카테고리

엔드포인트

연호 및 날짜

wareki/convert, holiday/check, age/calculate

법률 및 세금

invoice/validate, invoice/verify, tax/calculate

법인

houjin/lookup, industry/lookup

주소

postal/lookup, address/normalize, region/lookup

텍스트

name/romanize, kanji/to-kana, kana/convert, text/normalize

금융

bank/lookup, bank/transfer/validate, yucho/convert

신원 확인

mynumber/validate, phone/validate, passport/validate


라이선스

MIT — 예제 코드에만 해당합니다. Torify API 서비스는 독점 소프트웨어입니다.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Provides Japanese UX conventions as an MCP server to help AI generate correct Japanese UI elements like proper name order, furigana, phone formats, and polite language. It includes tools for form generation, validation, keigo suggestions, and cultural adaptation for developers building Japanese-facing products.
    6
    112
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Japan-specific utilities for AI agents — era ↔ Western year conversion, kanji-to-romaji, postal code lookup, national holidays, kana conversion, and Japanese name splitting. 9 tools, MIT licensed, install via uvx.
    9
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/torify-dev/torify-examples'

If you have feedback or need assistance with the MCP directory API, please join our Discord server