Japan Bank Code

● Active

io.github.nick353/jp-bank-code

Japanese bank/branch codes with kana, transfer pre-checks, Japan Post Bank conversion. No API key.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "jp-bank-code": {
      "url": "https://jp-bank-code-mcp.nichika2000823.workers.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http jp-bank-code https://jp-bank-code-mcp.nichika2000823.workers.dev/mcp
VS Code
code --add-mcp '{"name":"jp-bank-code","type":"http","url":"https://jp-bank-code-mcp.nichika2000823.workers.dev/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.1.0
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Japan Bank Code is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 4 days ago (Nov 18, 2026), 0 open issues.
Official registry
Active
Published as io.github.nick353/jp-bank-code in the official MCP registry, version 0.1.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to jp-bank-code-mcp.nichika2000823.workers.dev: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Working105 msprotocol 2025-06-18v0.1.0tools

The endpoint answered the MCP handshake as "Japan Bank Code (bank and branch codes, Japan Post Bank conversion)" and listed 4 tools. Answering since Nov 18, 2026.

Context cost ≈ 586 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 4 tools.

Tools (4)

  • lookup_bank1 param

    Find a Japanese financial institution by 4-digit bank code (金融機関コード) or by name in kanji, kana (full or half width) or romaji. Covers banks, shinkin, credit unions, JA and more.

    Show parameters
    • querystringrequiredBank code or name, e.g. 0001, みずほ, ミズホ, mizuho
  • lookup_branch2 params

    Find a branch of a Japanese bank by 3-digit branch code (支店コード) or by branch name / kana.

    Show parameters
    • bankstringrequired4-digit bank code or exact bank name
    • querystringrequiredBranch code or name, e.g. 001, 東京営業部, シブヤ
  • verify_bank_branch2 params

    Before a domestic bank transfer, check that a bank code + branch code pair exists and return the official names and kana (as used in zengin transfer files).

    Show parameters
    • bank_codestringrequired4 digits
    • branch_codestringrequired3 digits
  • yucho_to_transfer2 params

    Convert a Japan Post Bank (ゆうちょ銀行) 記号・番号 into the branch name, branch code, account type and account number needed to receive transfers from other banks, using the official rule (e.g. 11940-12345671 -> 198 一九八店 普通 1234567). Nothing is stored.

    Show parameters
    • symbolstringrequired記号, 5 digits
    • numberstringrequired番号, up to 8 digits

Checked by Serverdex with a plain initialize + tools/list call to jp-bank-code-mcp.nichika2000823.workers.dev/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 18, 2026
License
MIT

TypeScript

From the README

Japan Bank Code MCP An MCP server for the Japanese bank codes an agent needs when paying or getting paid in Japan: • Bank lookup — 4-digit bank code (金融機関コード) ⇄ name, by kanji, kana (full or half width) or romaji. 1,146 institutions: banks, shinkin, credit unions, JA, labor banks • Branch lookup — 3-digit branch code (支店コード) ⇄ branch name and kana. 28,944 branches • Transfer pre-check — verify a bank + branch pair and get the official kana used in zengin transfer files • Japan Post Bank conversion — ゆうちょ 記号・番号 → branch code, 漢数字 branch name, account type and account number for transfers from other banks (official rule) No API key, no sign-in, read-only. Nothing you send is stored. Connect Streamable HTTP endpoint: https://jp-bank-code-mcp.nichika2000823.workers.dev/mcp Any MCP client that supports remote (Streamable HTTP) servers works the same way: Cursor, VS Code, ChatGPT, Gemini CLI. Tools 日本語 金融機関コード・支店コードを名前やカナで引き、振込の前に銀行と支店の組み合わせを確かめ、ゆうちょ銀行の記号番号を他行からの振込用(店名・店番・口座番号)に変える MCP サーバーです。 Data Bank and branch data: zengin-code/source-data (MIT). Each result shows dataupdatedat; branches opened, closed or merged after that date may be missing. Japan Post Bank rule: ゆうちょ銀行「記号・番号から振込用の店名・預金種目・口座番号への変換の公式」. Usage is counted with a salted hash of the caller that rotates every two weeks; raw IP addresses are not stored. MIT License.

Read the full README on GitHub →

Remotes

  • streamable-httphttps://jp-bank-code-mcp.nichika2000823.workers.dev/mcp

The most-starred Developer Tools servers in the index, with their live-check result.

ServerStarsLast pushLive check
REA466,935Nov 2026Local / not checked
GitHub34,658Nov 2026Needs sign-in
Repomix29,280Nov 2026Local / not checked
Compiler Explorer19,201Nov 2026Working
XERJ19,135Nov 2026Local / not checked

Japan Bank Code: questions people ask

Is Japan Bank Code a remote or a local MCP server?
According to its entry in the official MCP registry, Japan Bank Code ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Japan Bank Code need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Japan Bank Code safe to use?
Looks healthy: Japan Bank Code is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Japan Bank Code still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
What tools does Japan Bank Code expose?
4 tools as listed by the server itself during the live check, including lookup_bank, lookup_branch, verify_bank_branch, yucho_to_transfer. The full list with parameters is in the Live check section above.
How do I add Japan Bank Code to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Japan Business IDValidate Japanese invoice registration numbers (T+13) and corporate numbers. No API key.
  2. Japan CalendarJapanese national holidays, business days and wareki (era) dates, exact not guessed. No API key.
Browse all Developer Tools →

Add the badge to your site

Show visitors that Japan Bank Code is listed here — it’s also the link we check for a free listing.

Japan Bank Code — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-nick353-jp-bank-code?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Japan Bank Code — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Japan Bank Code — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-nick353-jp-bank-code?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-nick353-jp-bank-code) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-nick353-jp-bank-code) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-nick353-jp-bank-code)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-nick353-jp-bank-code"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-nick353-jp-bank-code"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-nick353-jp-bank-code"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).