{
  "markdown": "# ibanchecker-mcp\n\n[![npm version](https://img.shields.io/npm/v/@ibanchecker/mcp.svg)](https://www.npmjs.com/package/@ibanchecker/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n[![Model Context Protocol](https://img.shields.io/badge/MCP-server-6E56CF.svg)](https://modelcontextprotocol.io)\n\nMCP (Model Context Protocol) server for [ibanchecker.cash](https://ibanchecker.cash). Gives AI assistants like Claude five finance tools backed by the ibanchecker.cash validation engine:\n\n| Tool | What it does |\n|------|--------------|\n| `validate_iban` | Validate a single IBAN: country, length, national BBAN structure, MOD-97 check digits, and bank details when available |\n| `validate_bulk_ibans` | Validate up to 100 IBANs in one call |\n| `extract_ibans_from_text` | Find and validate every IBAN inside a block of text (emails, invoices, spreadsheets) |\n| `get_iban_format` | IBAN format specification for any of 90 supported countries |\n| `lookup_bic` | Look up a bank by BIC/SWIFT code |\n\nNo IBAN data is logged or stored; validation runs in memory on Cloudflare's edge. See the [security page](https://ibanchecker.cash/security) for details.\n\n## Quick start: hosted remote server\n\nThe easiest path is the hosted endpoint. Nothing to install or deploy.\n\n```\nhttps://mcp.ibanchecker.cash/mcp\n```\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http ibanchecker https://mcp.ibanchecker.cash/mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`), via the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge:\n\n```json\n{\n  \"mcpServers\": {\n    \"ibanchecker\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.ibanchecker.cash/mcp\"]\n    }\n  }\n}\n```\n\n## Local stdio server\n\nRun the server locally over stdio (requires Node 18+):\n\n```json\n{\n  \"mcpServers\": {\n    \"ibanchecker\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ibanchecker/mcp\"],\n      \"env\": {\n        \"IBANCHECKER_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Example\n\nCalling `validate_iban` with `DE89370400440532013000` returns:\n\n```json\n{\n  \"valid\": true,\n  \"iban\": \"DE89370400440532013000\",\n  \"formatted\": \"DE89 3704 0044 0532 0130 00\",\n  \"country_name\": \"Germany\",\n  \"bank_name\": \"Commerzbank AG Cologne\",\n  \"bic\": \"COBADEFFXXX\",\n  \"bank_code\": \"37040044\",\n  \"account_number\": \"0532013000\",\n  \"sepa\": true\n}\n```\n\nWhen the API returns an error (for example a `429` rate limit or `401` bad key), the tool result is flagged with `isError: true` and a human-readable message, so the assistant can react rather than crash.\n\n## API key\n\nThe underlying REST API has a free tier (1,000 requests/month). Get a key at [ibanchecker.cash/api-docs](https://ibanchecker.cash/api-docs) and pass it as:\n\n- `IBANCHECKER_API_KEY` env var (stdio mode), or\n- `Authorization: Bearer <key>` / `x-api-key` header (remote mode).\n\n## Project layout\n\n```\n.\n├── bin/stdio.mjs      # npm CLI entry (published as `ibanchecker-mcp`)\n├── shared/tools.mjs   # the 5 tool definitions, shared by both transports\n└── worker/            # Cloudflare Worker (the hosted remote server)\n    ├── src/index.ts\n    └── wrangler.toml\n```\n\nBoth the stdio CLI and the Worker register the exact same tools from `shared/tools.mjs`, so there is a single source of truth.\n\n## Self-hosting the Worker\n\nThe remote server is a Cloudflare Worker built on the [Agents SDK](https://developers.cloudflare.com/agents/). Deploy your own:\n\n```bash\ncd worker\nnpm install\nnpx wrangler deploy\n```\n\nRemove 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`.\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n",
  "bytes": 3713,
  "sha": "095fade41075553d8bc59a418290a63fef1bd7f66a5009c52820621d0f86dee2",
  "repo_slug": "koraykoylu/ibanchecker-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_koraykoylu_ibanchecker_mcp_cd5f457b/readme"
}