# Torify — Japanese Locale APIs for AI Agents

> Production-ready REST API + MCP server for Japanese locale conversion.
> 42 endpoints: wareki (imperial era), invoice T-number, corporate number (法人番号),
> postal code, address normalization, phone validation, kanji-to-kana, romanization,
> banking, geo, law search, consumption tax, and more.

## Base URL

https://torify.dev

## Pricing

- Trial: free (email signup, 100 calls/month)
- MCP: free (no auth, 100 req/day/IP)
- Pay-per-call: $0.02/call USDC via x402 (Base L2 or Solana)
- Pro: $19/month (10,000 calls/month)
- Enterprise: $149/month (1,000,000 calls/month)

## Documentation

- /docs (HTML API reference)
- /openapi (OpenAPI 3.1 JSON spec)
- /.well-known/x402 (x402 payment endpoint discovery)
- /.well-known/agent.json (A2A agent card)

## Changelog

- /changelog (HTML view — release notes with category badges and JSON-LD NewsArticle schema per entry)
- /changelog.xml (RSS 2.0 feed — subscribe for updates)

## MCP Server

URL: https://torify-mcp.torify.workers.dev
Protocol: Streamable HTTP MCP
Auth: none required (rate-limited by IP)
Tools: 10 unique tools (wareki, invoice, houjin, postal, phone, address, romanize, kanji-to-kana, bank, tax)

Add to Claude Desktop / Cursor / Cline:
{"type":"http","url":"https://torify-mcp.torify.workers.dev"}

## Key Endpoints (REST)

- GET /v1/wareki/convert?date=2024-01-01        Japanese era conversion
- GET /v1/invoice/verify?invoiceNumber=T1234567890123  NTA registry lookup
- GET /v1/houjin/lookup?number=7000012050002    Corporate number lookup
- GET /v1/postal/lookup?zipcode=1000001         Postal code → address
- GET /v1/phone/validate?phone=0312345678       Phone number normalization
- GET /v1/address/normalize?address=...         Address normalization
- GET /v1/name/romanize?name=山田太郎            Hepburn romanization
- GET /v1/kanji/to-kana?text=漢字               Kanji → kana (AI-powered)
- GET /v1/tax/calculate?amount=1000&rate=10     Consumption tax
- GET /v1/geo/geocode?address=東京都千代田区      GSI geocoding

## Authentication

x-trial-key: <trial_key>   # From /v1/trial/signup (free, 100 calls/month)
x-api-key: <api_key>       # From Polar subscription (Pro/Enterprise)
X-PAYMENT: <x402_token>    # Auto-generated by x402-fetch library

## Contact

Email: contact@torify.dev
GitHub: https://github.com/torify-dev/torify-examples