IBANTEST for AI Agents
Connect your AI assistant directly to the IBANTEST API via the Model Context Protocol (MCP) – for automatic IBAN validation, IBAN calculation and bank data queries.
What is the Model Context Protocol (MCP)?
The Model Context Protocol (MCP) was developed by Anthropic as an open standard and is now supported across the industry. It allows AI models and agents to access external tools and data sources in a structured way – securely, standardised, and in real time.
How MCP works
AI Agent
Cursor, Claude, ChatGPT or your own agent makes a request
MCP Protocol
Standardised JSON-RPC communication via HTTP or STDIO
IBANTEST API
Validates IBANs, calculates IBANs, provides bank data
With MCP, developers no longer need to build custom API integrations. The AI agent automatically discovers which tools the IBANTEST MCP server provides and can call them independently.
Why use IBANTEST via MCP?
AI-native integration
Your AI agent uses IBAN validation and bank data directly – without manual code or API calls.
Real-time bank data
Up-to-date bank codes, BIC codes and IBAN validations directly from our database.
Secure & controlled
Token-based authentication on every call. No token is stored in the session.
Multi-country support
IBAN calculation for DE, AT, BE, CZ, ES, IT, LI, LU, MC and NL.
What can an AI agent do with IBANTEST MCP?
The AI agent automatically calls
iban_validate and presents the result.
Validate IBANs
Verify IBANs for validity including check digit, length and bank data
Calculate IBANs
Generate IBANs from bank code and account number
Look up bank data
Validate BIC codes or find banks by country code and bank code
Available MCP tools
The IBANTEST MCP server provides the following tools that AI agents can automatically discover and use:
| Tool | Description | Parameters |
|---|---|---|
iban_validate |
Validate IBAN and retrieve bank data | iban |
iban_calculate_de |
Calculate German IBAN | bankCode, account |
iban_calculate_at |
Calculate Austrian IBAN | bankCode, account |
iban_calculate_be |
Calculate Belgian IBAN | bankCode, account, checkDigits |
iban_calculate_cz |
Calculate Czech IBAN | bankCode, account, prefix (optional) |
iban_calculate_es |
Calculate Spanish IBAN | bankCode, branch, account |
iban_calculate_it |
Calculate Italian IBAN | cin, abi, cab, account |
iban_calculate_li |
Calculate Liechtenstein IBAN | bankCode, account |
iban_calculate_lu |
Calculate Luxembourg IBAN | bankCode, account |
iban_calculate_mc |
Calculate Monaco IBAN | bankCode, branch, account |
iban_calculate_nl |
Calculate Dutch IBAN | bankCode, account |
bank_validate_bic |
Validate BIC/SWIFT code | bic |
bank_find |
Find bank by country code and bank code | country, bankCode |
account_get_credits |
Query remaining credits | — |
token parameter for authentication. You will receive this after free registration.
Quick start: Set up IBANTEST MCP
1 Create an IBANTEST account
Register for free and copy your API token from the account area.
2 Configure your MCP client
Add the IBANTEST MCP server in your preferred tool:
File: .cursor/mcp.json in your project
{
"mcpServers": {
"ibantest": {
"url": "https://api.ibantest.com/mcp"
}
}
}
Claude Desktop configuration:
{
"mcpServers": {
"ibantest": {
"url": "https://api.ibantest.com/mcp"
}
}
}
Direct HTTP access to the MCP endpoint:
POST https://api.ibantest.com/mcp
Content-Type: application/json
Accept: application/json
3 Start using it!
Your AI agent automatically discovers the available IBANTEST tools. Simply ask questions like:
- “Validate the IBAN DE89370400440532013000”
- “Calculate the IBAN for bank code 50010517 and account 1234567890”
- “Find the bank with BIC DEUTDEFF”
Technical details: HTTP workflow
For custom integrations, the MCP HTTP workflow follows a simple pattern:
1. Initialise session
{
"jsonrpc": "2.0",
"id": "init-1",
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": { "name": "my-agent", "version": "1.0.0" }
}
}
Use the Mcp-Session-Id from the response for all subsequent calls.
2. Call a tool (example: validate IBAN)
{
"jsonrpc": "2.0",
"id": "call-1",
"method": "tools/call",
"params": {
"name": "iban_validate",
"arguments": {
"token": "YOUR_API_TOKEN",
"iban": "DE89 3704 0044 0532 0130 00"
}
}
}
3. Close session
DELETE https://api.ibantest.com/mcp
Header: Mcp-Session-Id: <SESSION_ID>
Compatible MCP clients
Cursor IDE
Native MCP support for IBAN operations directly in the IDE
Claude Desktop
Use the MCP server directly in the Claude Desktop app
Custom agents
Integrate via HTTP transport into any MCP-compatible client
API / Developer
MCP at a Glance
- 14 available tools
- IBAN validation & calculation
- Optimised for AI agents
- HTTP & STDIO transport
Why IBANTEST via MCP?
Four reasons why the MCP interface revolutionises your AI workflows
Open Standard
MCP is an industry-wide supported standard – no proprietary interfaces.
Real-time Data
Up-to-date bank data, IBAN validations and BIC search in real time.
Secure & Controlled
Token-based authentication on every single call.
Easy Integration
Set up in under 5 minutes – for Cursor, Claude and other MCP clients.
Ready for AI-powered bank data?
Register for free now and connect your AI agent with IBANTEST.