Add to Claude Desktop in 30 seconds

Free tier — no API key, no wallet needed.

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

Or via CLI: claude mcp add torify --transport http https://torify-mcp.torify.workers.dev
Free tier limit: 100 requests/day/IP. No API key or wallet required.

Core Primitives

The 6 endpoints that handle 80% of Japan-localization needs for AI agents.

Quick Start (REST / x402)

Authentication: attach X-PAYMENT (x402 USDC) or X-API-Key (subscription). Free endpoints below need neither.

# Verify a Japanese invoice number against NTA
curl "https://torify.dev/v1/invoice/verify?number=T1234567890123"   -H "X-PAYMENT: <base64-payment>"

# Look up a company by corporate number (法人番号)
curl "https://torify.dev/v1/houjin/lookup?number=7000012050002"   -H "X-PAYMENT: <base64-payment>"

# Consumption tax (no payment header required on local dev)
curl "https://torify.dev/v1/tax/calculate?amount=10000&category=standard"

# Japanese public holiday check
curl "https://torify.dev/v1/holiday/check?date=2026-05-03"

# Wareki → Gregorian
curl "https://torify.dev/v1/wareki/convert?direction=g2w&date=2026-05-08"

# Phone number E.164 normalization
curl "https://torify.dev/v1/phone/validate?phone=03-1234-5678"

Example Responses

Every endpoint returns {"ok":true,"data":{...}} on success, or {"ok":false,"error":{"code":"...","message":"..."}} on failure.

{
  "ok": true,
  "data": {
    "era": "令和", "eraYear": 8, "eraRomaji": "Reiwa",
    "formatted": "令和8年5月8日", "gregorian": "2026-05-08"
  }
}

{
  "ok": true,
  "data": {
    "number": "T1234567890123", "registered": true,
    "confidence": 0.99, "registrantName": "株式会社サンプル",
    "verified_at": "2026-05-08T12:00:00Z"
  }
}

{
  "ok": true,
  "data": {
    "houjinBangou": "7000012050002", "name": "国税庁",
    "address": "東京都千代田区霞が関３丁目１－１",
    "status": "active", "confidence": 0.99
  }
}

x402-fetch SDK (TypeScript)

For AI agents that pay per call — no subscription needed. USDC on Base L2.

// Agent sends USDC automatically on every 402 response
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';
import { wrapFetchWithPayment } from 'x402-fetch';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({ account, chain: base, transport: http() });
const fetch402 = wrapFetchWithPayment(fetch, walletClient);

// Pays $0.02 USDC automatically — agent just calls the API
const res = await fetch402('https://torify.dev/v1/invoice/verify?number=T1234567890123');
const { ok, data } = await res.json();
// { ok: true, data: { registered: true, confidence: 0.99, ... } }

Data sources: Corporate & invoice data from Japan NTA official API. Wareki, holiday, and postal data are offline tables. Kanji-to-kana uses Cloudflare Workers AI (Llama 3.3 70B inference).

All Endpoints — $0.02 / call

Flat rate for all 42 endpoints. USDC on Base via x402 protocol.

📅 Calendar & Dates

Japanese era dates, public holidays, statutory rest days, and age/school-year calculations.

⚖️ Legal & Tax

Invoice validation & NTA registry lookup, consumption tax calculation, electronic bookkeeping compliance, and law search.

🏢 Corporate & KYC

Corporate number (法人番号) lookup, My Number validation, and industry classification.

🗺️ Geo & Address

Postal code → address lookup, address normalization, JIS X 0402 region codes, WGS84 ↔ JGD2011 coordinate conversion, and GSI geocoding.

💰 Finance & Banking

Zengin bank/branch lookup, bank search and listing, transfer format validation, Japan Post account conversion, and 3D Secure applicability.

📝 Text & Names

Kanji reading, kana conversion, NFKC normalization, name romanization, name validation, and surname/given-name splitting.

🆔 Identity & Validation

Passport, social insurance, license plate, JAN barcode, MEXT school code, and Japanese phone number validation.

🛠️ Diagnostics

Free utility endpoints for connection diagnostics.

Subscription Plans

Available On

Find and install Torify through AI agent marketplaces and discovery networks.

Documentation

Full API docs  ·  OpenAPI 3.1  ·  A2A Agent Card  ·  Service Status  ·  Uptime Monitor ↗  ·  llms.txt  ·  llms-full.txt

FAQ