MCP.Market

Ja Normalize MCP server

by KojimaHyui01·io.github.KojimaHyui01/ja-normalize·v0.1.2
No reviews yet

Holidays/business days for 200+ countries; Japanese address, name, bank and company normalization.

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars437 downloads/wk

Reviews

Write one

Nobody has reviewed Ja Normalize yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ja Normalize tools (12)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • business_day

    Is a date a business day in a country? Add/subtract N business days honouring holidays and the local weekend (e.g. Fri-Sat in Saudi Arabia).

  • holiday_countries

    Lists supported country codes, or the regions of one country when `country` is given.

  • holidays

    Public/bank/school holidays for a country and year, with optional region (US-CA → region=CA) and type filter.

  • jp_address_normalize

    Normalizes any Japanese address notation to pref/city/town/block against the Address Base Registry and returns WGS84 coordinates.

  • jp_bank_lookup

    Exact lookup of a 4-digit bank code (+ optional 3-digit branch code).

  • jp_bank_resolve

    Fuzzy-resolve a bank (銀行/信金/信組/労金/JA) and optional branch name to 金融機関コード and 支店コード, with half-width kana for 全銀 files.

  • jp_business_day

    Japanese holidays incl. 振替休日/国民の休日; add N business days; 月末営業日; calendar=bank also closes Dec 31–Jan 3.

  • jp_company_resolve

    Fuzzy company-name or 13-digit corporate-number lookup with registered address and invoice-number format.

  • jp_crypto_ticker

    BTC/ETH/XRP prices on bitFlyer, Coincheck, GMO Coin and bitbank, cross-exchange median, USD reference, USD/JPY and the Japan premium vs USD.

  • jp_name_parse

    Splits a kanji full name, returns ranked reading candidates with confidence and 外務省 passport romaji. Pass `kana` ("<family> <given>") when known for a deterministic result.

  • jp_name_romaji

    Deterministic romanization: passport form (SATO, ONO, NAMBA), OH-style, macron and strict forms. Input "さとう ゆうこ" or a single token.

  • jp_text_normalize

    Full-width → half-width, 和暦 → ISO dates, extracts phone numbers (E.164), postal codes and emails from free text.

Public scan report

scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 20 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Ja Normalize compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 75% of 1,761 Finance servers
Tools
12
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
437
more than 90% of 421 Finance servers with a package

What its tools let an agent do: 12 read

Install Ja Normalize in Claude Code, Cursor or VS Code

Runs npx -y ja-normalize-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add ja-normalize -- npx -y ja-normalize-mcp
Add to Cursor

What the publisher says

From the Ja Normalize repository's README, as published. We do not edit it. Read it on GitHub

x402-ja-api

日本語テキストを「構造化」して返すAPI群。AIエージェントが x402 プロトコルで1コールごとにUSDCを払って使う。

無料で読めるもの: GET / GET /health GET /openapi.json GET /.well-known/x402 GET /llms.txt GET /v1/holidays/countries

売上ダッシュボード（運営者専用 / STATS_TOKEN 必須）: https://x402-ja-api.onrender.com/stats — 累計受取USDC・件数・支払元数・日別・直近入金（オンチェーン、Blockscout）＋起動後のエンドポイント別 paid/free/402 カウンタ。?format=json で機械向け。

動かす

cp .env.example .env      # PAY_TO_ADDRESS を自分のウォレットに
npm install
npm run dev               # http://localhost:4021
npm run doctor            # 発見用ドキュメントと402応答の自己診断
npm run check             # 型チェック + テスト

未払いで叩くと 402 と PAYMENT-REQUIRED ヘッダ（base64 JSON）が返る:

curl -i -X POST localhost:4021/v1/text/normalize \
  -H 'Content-Type: application/json' \
  -d '{"text":"令和５年４月１日 ＴＥＬ ０３－１２３４－５６７８"}'

支払いを含むE2E（テストネット・買い手用の別ウォレットが必要）:

# Base Sepolia の USDC を https://faucet.circle.com で受け取っておく
BUYER_PRIVATE_KEY=0x... npm run probe -- http://localhost:4021 /v1/text/normalize

本番に出す手順

（facilitator手数料: 1,000件まで無料、以降 $0.001/件。ガス代はfacilitator負担）

  1. ウォレット: 受取専用のEVMアドレスを新規作成し PAYTOADDRESS に設定（秘密鍵はサーバーに置かない。受け取るだけなので不要）
  2. Coinbase CDP: https://portal.cdp.coinbase.com でAPIキーを発行 → CDPAPIKEYID / CDPAPIKEYSECRET、X402_NETWORK=base

発行まで2〜4週間。届くまで /v1/company/resolve は 503 を返す

  1. 法人番号API: https://www.houjin-bangou.nta.go.jp/webapi/ でアプリケーションIDを申請 → HOJINAPPID
  1. デプロイ: 恒久的なドメインが必須（x402scanはngrok等のトンネルを拒否）。Render / Fly.io / Railway の無料〜最小プランで十分。PUBLICBASEURL を実URLに
  2. 自己診断: npm run doctor -- https://your-domain
  3. 登録（発見されるため）
  • x402scan: POST https://www.x402scan.com/api/x402/registry/register-origin {"origin":"https://your-domain"} または UI から
  • CDP Bazaar: 最初の決済が通ると自動索引（declareDiscoveryExtension 済み）
  • Circle Agent Marketplace: https://agents.circle.com/services の申請フォーム
  • x402Relay（日本）: https://x402relay.jp 系のカタログに申請

構成

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ja Normalize: common questions

Is Ja Normalize MCP server safe?
Mostly: it is graded B (83/100). Read the Ja Normalize safety report
How do I install Ja Normalize?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ja Normalize need an API key?
Yes. The registry entry asks for X402_PRIVATE_KEY.
Is Ja Normalize maintained?
The last commit was 51 days ago (2026-09-14). The latest release is v0.1.2.
What can I use instead of Ja Normalize?
Servers from other publishers that do the same job: Worldbank MCP server, Finance Toolkit MCP server and BankMCP™ MCP server.
How does Ja Normalize compare with other Finance MCP servers?
safety score 83/100 (higher than 75% of 1,761 Finance servers); tools 12 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Ja Normalize

Same job from other publishers: the closest match first, then the best rated.

  • Worldbank
    Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.
    A
  • Finance Toolkit
    200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
    A
  • BankMCP™
    Read-only MCP server for your own bank accounts via Enable Banking. Self-hosted, one user.
    A
  • Beancount.io
    Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
    A
  • Bcra
    BCRA — Argentine Central Bank public data (exchange rates, inflation, reserves)
    More from codespar →
    A