IBAN Checker MCP

by koraykoylu

333 downloads

Not rated

GitHub

Other

About

IBAN validation, extraction, format specs, and BIC/SWIFT lookup tools for AI assistants, backed by ibanchecker.cash. Covers 90 countries; no IBAN data is stored.

Details

Author: koraykoylu
Downloads: 333
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name IBAN Checker MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Use the hosted endpoint at https://mcp.ibanchecker.cash/mcp or run it locally with npx -y @ibanchecker/mcp. For Claude Code, add it via claude mcp add --transport http ibanchecker https://mcp.ibanchecker.cash/mcp. A free API key (1,000 requests per month) is available at https://ibanchecker.cash/api.

`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 fields such as `valid` (boolean), `countryCode`, `checkDigitsValid`, the `formatted` IBAN, and an optional `bank` object. On a malformed input the call still succeeds with `valid: false` and a `reason` (e.g. INVALID_FORMAT, INVALID_CHECKSUM); it does not throw for invalid IBANs. 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.

`validate_bulk_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 a JSON array of per-IBAN results in the same order as the input, each with `valid`, `countryCode`, an optional `reason` for failures, and bank details when the code is recognized, plus a summary count of valid vs. invalid entries. 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.

`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 a JSON array of the IBANs found, each with its validation result (`valid`, `countryCode`, bank details when known); 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.

`get_iban_format`

Return the IBAN format specification for a country, covering 90 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.

`lookup_bic`

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 the bank name, city, ISO country code, SEPA membership, and (when available) the official website and Wikidata entity. 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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

IBAN Checker MCP

MCP server for ibanchecker.cash. Gives AI assistants five finance tools backed by the ibanchecker.cash validation engine, covering 90 countries. No IBAN data is logged or stored.

Tools

- validate_iban: validate a single IBAN (country, length, BBAN structure, MOD-97 check digits, and bank details when available) - validate_bulk_ibans: validate up to 100 IBANs in one call - extract_ibans_from_text: find and validate every IBAN inside a block of text - get_iban_format: IBAN format specification for any of 90 supported countries - lookup_bic: look up a bank by BIC/SWIFT code

Install

Remote (hosted): https://mcp.ibanchecker.cash/mcp Claude Code: claude mcp add --transport http ibanchecker https://mcp.ibanchecker.cash/mcp Local (stdio): npx -y @ibanchecker/mcp

Links

- npm: https://www.npmjs.com/package/@ibanchecker/mcp - GitHub: https://github.com/koraykoylu/ibanchecker-mcp - Free API key (1,000/mo): https://ibanchecker.cash/api-docs

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

validate_iban

validate_bulk_ibans

extract_ibans_from_text

get_iban_format

lookup_bic

Claude Desktop / Cursor

McpServers

IBAN Checker MCP

Tools

Install

Links

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`validate_iban`

`validate_bulk_ibans`

`extract_ibans_from_text`

`get_iban_format`

`lookup_bic`