Skip to main content
Glama
deenesjakoruzh
torify-dev

Torify — Japanese Locale APIs for AI Agents

by torify-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

torify-examples

Ejemplos de código para Torify — APIs de configuración regional japonesa para agentes de IA.

31 endpoints para wareki (fechas de era), validación de facturas, búsqueda corporativa, normalización de direcciones y más.

torify.dev License: MIT

Inicio rápido

Nivel gratuito (MCP — sin billetera, sin registro)

Añadir a claude_desktop_config.json:

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

100 solicitudes/día/IP gratis. Funciona en Claude Desktop y Cursor.

x402 por llamada ($0.02 USDC en Base L2)

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

Suscripción con clave API ($49/mes)

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

Related MCP server: japan-ux-mcp

Ejemplos

Conversión de Wareki (fecha de era)

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

Validación de número de factura

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

Estado: La integración con el registro de la NTA está pendiente de aprobación de la API externa. Próximamente.

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

Búsqueda de número corporativo

Estado: La búsqueda de número corporativo está pendiente de aprobación de la API externa. Próximamente.

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

Búsqueda de código postal

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

Validación de número de teléfono

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

Normalización de direcciones

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

TypeScript con x402 (pago autónomo)

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

Python con clave API

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"])
# 東京都 千代田区 霞が関

Todos los endpoints

Documentación completa: torify.dev/docs

Categoría

Endpoints

Era y fecha

wareki/convert, holiday/check, age/calculate

Legal y fiscal

invoice/validate, invoice/verify, tax/calculate

Corporativo

houjin/lookup, industry/lookup

Dirección

postal/lookup, address/normalize, region/lookup

Texto

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

Finanzas

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

Identidad

mynumber/validate, phone/validate, passport/validate

Licencia

MIT — solo ejemplos. El servicio de API de Torify es propietario.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • japan-ux-mcp

    mrslbt
    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
    80 npm
    MIT

  • japan-utils-mcp

    vivek081166
    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
    29 PyPI
    MIT