Ibanchecker Mcp

io.github.koraykoylu由 GitHub 帳號 koraykoylu 發布v1.4.0更新於 Nov 2, 2026

IBAN validation, extraction, format specs and BIC/SWIFT lookup tools for AI assistants.

已驗證Streamable HTTP可網頁執行金融開發者工具

概覽

AI 產生的概覽

以 ibanchecker.cash 引擎為後端,驗證 IBAN、從文字中擷取 IBAN、查詢各國 IBAN 格式,並依 BIC/SWIFT 查詢銀行。

可以做什麼
  • 依 ISO 13616 驗證單一 IBAN 的國別、長度、BBAN 結構與 MOD-97 檢查碼,並在可用時回傳銀行資訊
  • 一次呼叫批次驗證最多 100 個 IBAN,並依輸入順序回傳逐筆結果
  • 掃描電子郵件、發票或貼上的 PDF 等自由文字,找出其中每個 IBAN 並逐一驗證
  • 回傳 92 個支援國家中任一國的 IBAN 格式規格,包含 BBAN 配置、範例與 SEPA 成員旗標
  • 依 8 碼或 11 碼 BIC/SWIFT 代碼查詢銀行,回傳名稱、城市與國家
適用情境
適合助理處理付款或銀行帳戶資訊的情境:轉帳前核對單一 IBAN、篩檢一批 IBAN、從發票或郵件中擷取帳號,或把 BIC 代碼解析成銀行名稱。
執行需求
可作為託管的遠端端點使用,也可透過 npm 套件以 stdio 在本機執行,需要 Node 18 以上版本。除 get_iban_format 外,所有工具都需要 API 金鑰:stdio 模式透過環境變數 IBANCHECKER_API_KEY 傳入,遠端模式透過 Authorization Bearer 或 x-api-key 標頭傳入。免費金鑰每月 100 次請求;批次驗證與擷取以每個 IBAN 計一次請求。
安裝前請注意
API 金鑰屬於機密,須由使用者自行提供;工具可用範圍取決於金鑰方案,401、403、429 錯誤會以工具錯誤形式回傳。IBAN 及周邊文字會傳送到託管的 ibanchecker.cash 服務,該服務聲明不記錄也不儲存 IBAN 資料。驗證結果不能證明帳戶真實存在或可收款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ibanchecker Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.koraykoylu%2Fibanchecker-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "ibanchecker": {
      "type": "http",
      "url": "https://mcp.ibanchecker.cash/mcp"
    }
  }
}

README

ibanchecker-mcp

[npm version] [License: MIT] [Model Context Protocol]

MCP (Model Context Protocol) server for ibanchecker.cash. Gives AI assistants like Claude five finance tools backed by the ibanchecker.cash validation engine:

ToolWhat it does
validate_ibanValidate a single IBAN: country, length, national BBAN structure, MOD-97 check digits, and bank details when available
validate_bulk_ibansValidate up to 100 IBANs in one call
extract_ibans_from_textFind and validate every IBAN inside a block of text (emails, invoices, spreadsheets)
get_iban_formatIBAN format specification for any of 92 supported countries
lookup_bicLook up a bank by BIC/SWIFT code

No IBAN data is logged or stored; validation runs in memory on Cloudflare's edge. See the security page for details.

Quick start: hosted remote server

The easiest path is the hosted endpoint. Nothing to install or deploy. Every tool except get_iban_format needs an API key (see API key).

https://mcp.ibanchecker.cash/mcp

Claude Code

bash
claude mcp add --transport http ibanchecker https://mcp.ibanchecker.cash/mcp --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop (claude_desktop_config.json), via the mcp-remote bridge:

json
{  "mcpServers": {    "ibanchecker": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.ibanchecker.cash/mcp", "--header", "Authorization:${AUTH_HEADER}"],      "env": {        "AUTH_HEADER": "Bearer your-api-key-here"      }    }  }}

Local stdio server

Run the server locally over stdio (requires Node 18+):

json
{  "mcpServers": {    "ibanchecker": {      "command": "npx",      "args": ["-y", "@ibanchecker/mcp"],      "env": {        "IBANCHECKER_API_KEY": "your-api-key-here"      }    }  }}

Example

Calling validate_iban with DE89370400440532013000 returns:

json
{  "valid": true,  "iban": "DE89370400440532013000",  "formatted": "DE89 3704 0044 0532 0130 00",  "country_name": "Germany",  "bank_name": "Commerzbank AG Cologne",  "bic": "COBADEFFXXX",  "bank_code": "37040044",  "account_number": "0532013000",  "sepa": true}

When the API returns an error (for example a 429 rate limit, a 401 missing or bad key, or a 403 tool outside the key's plan), the tool result is flagged with isError: true and a human-readable message, so the assistant can react rather than crash.

API key

Every tool except get_iban_format needs an API key, and what a key can call follows its plan:

ToolFree keyFree key with a verified accountBasic / StarterGrowth / Enterprise
validate_ibanyesyesyesyes
validate_bulk_ibansnoup to 10 IBANs a callup to 100up to 100
lookup_bicnoyesyesyes
extract_ibans_from_textnoup to 5,000 characters a calltrial with a verified accountup to 50,000
get_iban_formatyesyesyesyes

get_iban_format also works without a key, up to 100 requests an hour per IP. A free key covers 100 requests a month and arrives by email in seconds: get one at ibanchecker.cash/api-docs. A free account on the same address, at ibanchecker.cash/dashboard, opens the trials. Bulk validation and extraction count one request per IBAN. See ibanchecker.cash/pricing for higher volumes. Pass the key as:

  • IBANCHECKER_API_KEY env var (stdio mode), or
  • Authorization: Bearer <key> / x-api-key header (remote mode).

Project layout

.├── bin/stdio.mjs      # npm CLI entry (published as `ibanchecker-mcp`)├── shared/tools.mjs   # the 5 tool definitions, shared by both transports└── worker/            # Cloudflare Worker (the hosted remote server)    ├── src/index.ts    └── wrangler.toml

Both the stdio CLI and the Worker register the exact same tools from shared/tools.mjs, so there is a single source of truth.

Self-hosting the Worker

The remote server is a Cloudflare Worker built on the Agents SDK. Deploy your own:

bash
cd workernpm installnpx wrangler deploy

Remove the routes block in worker/wrangler.toml (or point it at your own domain) and optionally set a server-wide key with npx wrangler secret put IBANCHECKER_API_KEY.

License

MIT. See LICENSE.

來源:README.md,提交 110c899

工具

5

validate_iban

Validate IBAN

Validate a single International Bank Account Number (IBAN) against the official ISO 13616 structure for its country. What it checks: the country code, total length for that country, the national BBAN structure, and the MOD-97 check digits. When the bank/branch code maps to a known institution, the response also includes the bank name, BIC/SWIFT code, and country. Returns JSON with `valid` (boolean), `iban`, `formatted`, `country`, `country_name`, `check_digits`, `bban`, and, when the bank is recognized, `bank_name`, `bic`, `bank_code`, `bank_city`, `sepa` and `national_check_valid`. An invalid IBAN still returns a result, with `valid: false`, an `error` message and an `error_code` (e.g. INVALID_CHECKSUM, INVALID_LENGTH, UNKNOWN_COUNTRY); it does not throw. Use this when you have one account number to verify. For many IBANs prefer `validate_bulk_ibans`; to pull IBANs out of prose use `extract_ibans_from_text` first. No account data is stored; validation runs in memory and is discarded. Requires an API key; a free key from ibanchecker.cash/api-docs covers 100 requests a month.

輸入參數iban必填

validate_bulk_ibans

Validate Multiple IBANs

Validate a batch of up to 100 IBANs in one call, applying the same ISO 13616 checks as `validate_iban` (country, length, BBAN structure, MOD-97). Returns JSON with `count`, `valid_count`, `invalid_count` and `results`, one entry per IBAN in input order, each shaped like a `validate_iban` result. Use this instead of calling `validate_iban` in a loop when checking a list (e.g. a payment file or a column of supplier accounts). Split inputs larger than 100 into multiple calls. Account numbers are validated in memory and never stored. Requires an API key on the Basic plan or above; a free key whose address has a verified ibanchecker.cash account can try it with up to 10 IBANs per call. Each IBAN counts as one request.

輸入參數ibans必填

extract_ibans_from_text

Extract IBANs From Text

Scan a free-form block of text and pull out every candidate IBAN, then validate each one. Useful for unstructured sources such as emails, invoices, PDFs pasted as text, or chat messages where IBANs appear inline and may be split by spaces or surrounded by other words. Returns JSON with `count`, `valid_count`, `invalid_count` and `results`, one `validate_iban`-shaped entry per IBAN found; text containing no IBAN returns an empty list rather than an error. Use this as the first step when the account number is buried in prose; pass the extracted IBANs to `validate_bulk_ibans` only if you need to re-check them separately. Input text is processed in memory and not stored. Requires an API key on the Growth plan or above; a free key whose address has a verified ibanchecker.cash account can try it with up to 5,000 characters per call. Each IBAN found counts as one request.

輸入參數text必填

get_iban_format

Get Country IBAN Format

Return the IBAN format specification for a country, covering 92 supported IBAN-using countries. Returns JSON describing the country's total IBAN length, the BBAN layout (bank code, branch code, and account number positions and lengths), an example IBAN, and the SEPA-membership flag. Use this to understand or display how a country's IBAN is structured, to build input masks, or to explain a validation failure, not to validate a specific number (use `validate_iban` for that). An unsupported or unknown country code returns an error result describing the problem. Works without an API key, up to 100 requests an hour per IP.

輸入參數country_code必填

lookup_bic

Look Up Bank by BIC/SWIFT

Look up a financial institution by its BIC (Business Identifier Code, also called SWIFT code) and return the matching bank's details. Accepts an 8-character (head office) or 11-character (branch) BIC. Returns JSON with `bic`, `bic8`, `bank_name`, `city`, `country_code`, `country_name`, `sepa`, the institution `type` and its `status`. Use this to resolve a BIC to a human-readable bank, to confirm a SWIFT code is real, or to enrich a validated IBAN with institution details. An unknown or malformed BIC returns an error result rather than a guess; codes are never fabricated. Requires an API key on the Basic plan or above, or a free key whose address has a verified ibanchecker.cash account.

輸入參數bic必填

版本歷史

3
  1. v1.4.0最新Sep 27, 2026
  2. v1.3.0Sep 27, 2026
  3. v1.2.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分