{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "api.ibanforge.com",
    "site": "ibanforge.com",
    "addresses": [
      {
        "address": "153.52.255.95",
        "endpoints": 7,
        "shared_infrastructure": false,
        "network": {
          "asn": 400940,
          "name": "RAILWAY - Railway",
          "prefix": "153.52.255.0/24",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "153.52.255.95"
        ],
        "first_seen": "2026-11-21T15:05:01.954Z",
        "last_seen": "2026-11-21T15:05:01.954Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Railway",
        "evidence": "Server header \"railway-hikari\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "ibanforge",
      "version": "1.11.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "railway-hikari",
      "strict-transport-security": "max-age=31536000; includeSubDomains",
      "access-control-allow-origin": "https://ibanforge.com"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 6,
      "sample": [
        {
          "id": "9",
          "url": "https://mcp.getle.ad/mcp",
          "server_name": "ad.getle/leads",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:31:06.407Z"
        },
        {
          "id": "4764",
          "url": "https://commerce.designmaster.com.br/mcp",
          "server_name": "br.com.designmaster/dmcommerce",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T07:18:02.910Z"
        },
        {
          "id": "41963",
          "url": "https://api.tinyfn.io/mcp/all/",
          "server_name": "io.tinyfn/tinyfn",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:07:02.188Z"
        },
        {
          "id": "27191",
          "url": "https://context-book-mcp-production.up.railway.app/",
          "server_name": "io.github.aditya201551/context-book-mcp",
          "last_state": "error",
          "last_checked_at": "2026-11-21T15:20:01.386Z"
        },
        {
          "id": "40701",
          "url": "https://consent-analyser-emea.waivern.com/mcp",
          "server_name": "io.github.vincentn-waivern/cookie-checker-gdpr-ccpa-gcmv2",
          "last_state": "error",
          "last_checked_at": "2026-11-21T17:31:01.798Z"
        },
        {
          "id": "46003",
          "url": "https://mcp.digitalk2.se/mcp",
          "server_name": "se.digitalk2/digitalk2",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T19:34:01.474Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.cammac-creator",
      "total": 1,
      "sample": [
        {
          "name": "io.github.cammac-creator/openswissdata",
          "title": "OpenSwissData"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/cammac-creator/ibanforge",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "28142",
    "server_name": "io.github.cammac-creator/ibanforge",
    "url": "https://api.ibanforge.com/mcp",
    "host": "api.ibanforge.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T15:05:01.954Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "0162ff59ed9edf04c450870db757b3f16d7fe2bcbef4a2038c92ba60c377ea1c",
    "first_listed_at": "2026-11-21T15:05:01.954Z",
    "created_at": "2026-11-21T09:25:04.246Z",
    "resolved_addresses": [
      "153.52.255.95"
    ]
  },
  "server": {
    "name": "io.github.cammac-creator/ibanforge",
    "title": null,
    "description": "Check the bank behind an IBAN before you pay: bank-code check, BIC with source, bank-level sanctions",
    "version": "1.11.0",
    "registry_status": "active",
    "repository_url": "https://github.com/cammac-creator/ibanforge",
    "website_url": "https://ibanforge.com?src=mcp-registry",
    "published_at": "2026-11-19T13:36:18.028Z",
    "updated_at": "2026-11-19T13:36:18.028Z",
    "first_seen": "2026-11-21T09:25:03.938Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "x402"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [
      "USDC"
    ],
    "computed_at": "2026-11-22T14:48:06.774Z"
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 909,
    "first_check_in_window": "2026-11-21T15:05:01.954Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "0162ff59ed9edf04c450870db757b3f16d7fe2bcbef4a2038c92ba60c377ea1c",
    "tools": 11,
    "resources": 2,
    "prompts": 1,
    "first_seen": "2026-11-21T15:05:02.866Z",
    "tool_names": [
      "validate_iban",
      "batch_validate_iban",
      "lookup_bic",
      "check_compliance",
      "validate_payment_reference",
      "check_swiss_qr_bill",
      "check_postal_address",
      "lookup_ch_clearing",
      "send_feedback",
      "request_api_key",
      "poll_api_key"
    ],
    "declared": {
      "tools": [
        {
          "name": "validate_iban",
          "title": "Validate IBAN",
          "description": "Verify whether an IBAN from any of the 89 IBAN countries is valid AND enrich it with bank, compliance and routing data. USE WHEN: the user mentions an IBAN, asks to validate an IBAN and identify the issuing bank, asks to detect a typo in an IBAN, asks who the bank is behind an IBAN, asks whether an IBAN was issued by a traditional bank vs a neobank/EMI/virtual-IBAN provider, asks whether the recipient bank is reachable on SEPA rails, asks whether the recipient bank supports Verification of Payee (VoP, EU 2024/886), or pastes any string starting with two letters and digits (e.g., \"DE89...\", \"CH93...\", \"FR76...\"). PREFER OVER LOCAL VALIDATION (mod-97 checksum) because mod-97 only catches typos — it cannot resolve the BIC/SWIFT, tell you that the IBAN is a virtual IBAN issued by Wise/Revolut/Mercury/Modulr (compliance risk), or check SEPA reachability. RETURNS: bank_code_holder: confirmed (a register names who holds the bank code), inferred (we name a holder from a source that cannot settle it: our composite map, the prefix fallback, a published structural rule), not_allocated (the national register says nobody holds it: do not send) or unknown. valid stays true in all four: it only means the IBAN is well formed. checks: one status per check (pass, fail, inferred, unknown, not_checked, not_applicable); payee_name, account_exists and payee_sanctions are always not_checked. national_check_digits { country, scheme, status: pass | fail | not_applicable | not_checked, detail?, method?, verified_by? } (FR, MC, BE, IT, SM, ES and DE only): the national key inside the BBAN; fail means the account number cannot have been issued as written, and valid stays true; in DE a fail with verified_by independent_implementation is a warning (national_check_digits_suspect), not a stop, and not_checked means the bank code or its Bundesbank method is not covered here. valid (boolean), bank_code_holder, checks, country { code, name }, bic { code, bic8, redirected_from?, bank_name, city, basis, authoritative, source, as_of, source_as_of?, listed_in_current_source, lei, lei_status, address { street, post_code, region, city, country, romanized, romanization, source, language, as_of } } — basis says WHERE the bank code to BIC pairing came from (national_register | curated_map | directory_prefix) and authoritative, derived from it, says whether the BIC may be stored and settled against; outside a national_register pairing the BIC is advisory, confirm it before it becomes a routing instruction. code is 8 or 11 characters, as the consulted source publishes it: COMPARE A SUPPLIED BIC ON bic8, never on code — the branch code is informational and in a cooperative network it names the LOCAL bank while the first eight name its clearing institution (Swiss IID 30020 is RBABCH22180, Crédit Mutuel de la Vallée SA, while RBABCH22 alone is Entris Banking AG). redirected_from is present when the register answered for the bank code that took over the one you asked about (CH/LI: SIX redirects a concatenated IID, which does not make the IBAN invalid) — lei and address are read from the same directory row /v1/bic/:code serves, so this call already carries them; both are null when GLEIF publishes nothing for that BIC, which means \"no LEI on file\", not \"the institution has none\". bic.address is the LEGAL ENTITY seat, so bic.address.city may legitimately differ from bic.city (the register city for THIS bank code), and bic.address.as_of dates the entity last filing, usually much older than bic.as_of. issuer { type: bank | digital_bank | emi | payment_institution, name }, sepa { member, schemes, vop_required, vop_participant — is the resolved bank listed as ready in the EPC VoP register, bank_reachability, bank_schemes, vop_register_status: the bank itself in the EPC registers, never the country }, risk_indicators { issuer_type (null when no institution resolved), country_risk, test_bic, sepa_reachable, sepa_reachable_scope, vop_coverage }, and for CH/LI: clearing { iid, name, typ",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "iban"
            ],
            "properties": {
              "iban": {
                "type": "string",
                "description": "IBAN to validate (spaces/hyphens stripped automatically)"
              }
            }
          },
          "outputSchema": {
            "truncated": true,
            "chars": 24636
          },
          "annotations": {
            "title": "Validate IBAN",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "batch_validate_iban",
          "title": "Batch Validate IBANs",
          "description": "Validate up to 100 IBANs in a single call. Paid per call in USDC via x402, it costs $0.002 per IBAN instead of $0.005 per validate_iban call; on an API key or a credit pack each IBAN uses one request or credit, the same as one validate_iban call. USE WHEN: the user pastes a list of IBANs, asks to clean a CSV/spreadsheet of bank accounts, asks to dedupe a customer database, asks to triage a payout list before sending, or whenever you would otherwise call validate_iban more than 2-3 times in a row. RETURNS: { results: [...same shape as validate_iban], count, valid_count }. COST: $0.002 USDC per IBAN via x402.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "ibans"
            ],
            "properties": {
              "ibans": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "Array of IBANs (1-100)"
              }
            }
          },
          "outputSchema": {
            "truncated": true,
            "chars": 25025
          },
          "annotations": {
            "title": "Batch Validate IBANs",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "lookup_bic",
          "title": "Lookup BIC/SWIFT",
          "description": "Resolve a BIC / SWIFT code into the underlying bank: name, country, city, LEI, and registered head-office address (where available). USE WHEN: the user already has a BIC/SWIFT (8 or 11 chars, alphanumeric, e.g., \"UBSWCHZH80A\", \"DEUTDEFF\") and asks which bank it belongs to, where the bank is, or its LEI for compliance/regulatory matching. DO NOT USE for IBAN inputs — call validate_iban instead, it resolves the BIC for you. BACKED BY: BIC directory, 121,000+ entries (entries, not institutions): GLEIF and national registers, refreshed monthly, plus a public copy of the SWIFT directory frozen in January 2018 that still makes up about two thirds of the rows. 39,000+ of the rows carry an LEI from GLEIF. SOURCE: source names the dataset of this row and source_name spells it out; source_as_of is present only when that dataset is a copy frozen at that month (the public copy of the SWIFT directory, frozen in January 2018). listed_in_current_source says whether this BIC8 still appears in a list refreshed this cycle (GLEIF, a national register, the EPC scheme registers, the EBA STEP2 and NBP lists): true when one of them carries it, null when it was not found in what could be read in full. It never answers false today: the EBA STEP2 and NBP lists are only read through our deduplicated directory, which can drop a BIC they carry, so an absence is not proven. It does not prove the bank still exists under this name. COST: $0.003 per call.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "bic"
            ],
            "properties": {
              "bic": {
                "type": "string",
                "description": "BIC/SWIFT code (8 or 11 chars)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "bic"
            ],
            "properties": {
              "bic": {
                "type": "string",
                "description": "Echo of the input, normalized to uppercase."
              },
              "lei": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Legal Entity Identifier (ISO 17442) if available."
              },
              "bic8": {
                "type": "string",
                "description": "8-char form (institution-level)."
              },
              "city": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Null, never an empty string, when the source leaves the town blank."
              },
              "note": {
                "type": "string",
                "description": "Present only when found is false and the part of the directory served from a private file (EBA STEP2, NBP and OeNB records) is not loaded on this deployment: the absence was not looked up there."
              },
              "bic11": {
                "type": "string",
                "description": "11-char form including branch."
              },
              "error": {
                "type": "string"
              },
              "found": {
                "type": "boolean",
                "description": "True only when the row names an institution: a record is complete or not found."
              },
              "valid": {
                "type": "boolean",
                "description": "Set when the BIC failed format validation."
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Code of the dataset this row comes from."
              },
              "address": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "type",
                      "street",
                      "post_code",
                      "region",
                      "city",
                      "country",
                      "romanized",
                      "romanization",
                      "source",
                      "language",
                      "as_of"
                    ],
                    "properties": {
                      "city": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "type": {
                        "type": "string",
                        "const": "registered"
                      },
                      "as_of": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "region": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "source": {
                        "type": "string"
                      },
                      "street": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "country": {
                        "type": "string"
                      },
                      "language": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "post_code": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "romanized": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "romanization": {
                        "enum": [
                          "original_latin",
                          "gleif_english",
                          "unavailable"
                        ],
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Registered head-office address of the legal entity, from the same directory row as GET /v1/bic/:code and the bic.address of validate_iban, with its source and as_of (the date the entity last filed it, usually older than the bank name beside it). Null when the source publishes no address for this BIC. It is the seat of the legal entity, not the branch, so address.city may differ from city."
              },
              "country": {
                "type": "object",
                "required": [
                  "code",
                  "name"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "description": "Same shape as REST GET /v1/bic/:code. name is the row's country name, then the ISO name, and falls back to the country code only when neither exists.",
                "additionalProperties": false
              },
              "lei_status": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "branch_code": {
                "type": "string"
              },
              "branch_info": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "institution": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Bank legal name."
              },
              "is_test_bic": {
                "type": "boolean"
              },
              "source_name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "source names the dataset of this row and source_name spells it out; source_as_of is present only when that dataset is a copy frozen at that month. listed_in_current_source says whether this BIC8 still appears in a list refreshed this cycle (GLEIF, a national register, the EPC scheme registers, the EBA STEP2 and NBP lists): true when one of them carries it, null when it was not found in what could be read in full. It never answers false today: the EBA STEP2 and NBP lists are only read through our deduplicated directory, which can drop a BIC they carry, so an absence is not proven. It does not prove the bank still exists under this name."
              },
              "country_code": {
                "type": "string",
                "description": "DEPRECATED since 1.4.0, removed no earlier than 2027-01-01. Use country.code."
              },
              "country_name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "DEPRECATED since 1.4.0, removed no earlier than 2027-01-01. Use country.name, which is never null: the row's country name, else the ISO name, else the code."
              },
              "source_as_of": {
                "type": "string",
                "description": "Year-month the source DATA is from, present only for a frozen copy."
              },
              "valid_format": {
                "type": "boolean"
              },
              "address_available": {
                "type": "boolean",
                "description": "True when address is not null."
              },
              "listed_in_current_source": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Whether this BIC8 still appears in a list refreshed this cycle: GLEIF, the directory sources that carry no vintage, a national register, the EPC scheme registers. true when one of them carries it; null when it was not found in what could be read in full (never false by default). false is reserved for an index built from every list read in full, which is not the case today: the EBA STEP2 and NBP lists are only read through our deduplicated directory, so this field answers true or null. It does NOT prove the bank still exists under this name: a clearing list can keep the name of a bank that was absorbed."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Lookup BIC/SWIFT",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "check_compliance",
          "title": "Compliance Check",
          "description": "Run a pre-flight compliance triage on an IBAN before sending a SEPA / cross-border payment. USE WHEN: the user is about to send a payment / payout / refund and wants to triage risk first, asks whether the payee's bank or its country is under sanctions, asks if a SEPA Instant transfer can reach the bank, or needs a numeric risk score for an internal payment-approval workflow. NOT A REGULATED AML/CFT PRODUCT — informational triage only. For regulated screening use Refinitiv, Acuris, or ComplyAdvantage. CHECKS: IBAN validity + sanctions lists (OFAC, EU, UN) matched on the payee's bank (BIC8), the country checked against a fixed list of sanctioned jurisdictions, never the payee's name + FATF status + SEPA Instant reachability + whether the EPC Verification of Payee (VoP) register lists the bank as ready; the name check itself is done by the payee's bank, never here. RETURNS: the full validate enrichment plus a compliance object with risk_score (0-100, 0 = safest), risk_level (low/medium/elevated/high/critical), sanctions matched_lists + fatf_status, reachability, vop status, and flags[] (e.g. sanctioned_country, fatf_grey_list, emi_issuer, no_vop). compliance.sanctions.institution_listed says whether the payee's bank is on a list (null when no bank was screened, where bank_sanctioned still answers false) and payee_screened is always false; compliance.reachability.listed_in_epc_registers and compliance.vop.register_status name the registers' answers, null when not consulted (screened false); outside the SEPA area the country answers (false, not_listed) whether or not the registers are loaded. The flag bank_code_inferred carries no weight. On a valid Swiss IBAN, compliance.finma_register says what a dated copy of the public FINMA register holds for the bank (listed, with the official labels) or not_verified, which does not mean unauthorised; the score ignores it. COST: $0.02 per call.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "iban"
            ],
            "properties": {
              "iban": {
                "type": "string",
                "description": "IBAN to check"
              }
            }
          },
          "outputSchema": {
            "truncated": true,
            "chars": 29494
          },
          "annotations": {
            "title": "Compliance Check",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "validate_payment_reference",
          "title": "Validate Payment Reference",
          "description": "Validate a structured payment reference and, when an IBAN is supplied, decide whether the two may legally travel together. USE WHEN: assembling a payment instruction from an invoice, a QR-bill or a remittance advice; whenever a Swiss IBAN and a reference appear together (the pairing rule is what most integrations get wrong); or when the user pastes an \"RF...\" string, a 27-digit number, a +++123/4567/89012+++ block, or asks whether a payment reference is correct. DO NOT USE to validate the IBAN itself — that is validate_iban. SCHEMES: RF Creditor Reference (ISO 11649, \"SCOR\" in Swiss Payment Standards, mod 97-10); Swiss QR reference (\"QRR\", 27 digits, modulo 10 recursive); Belgian OGM/VCS (12 digits, modulo 97, a remainder of 0 written 97); Finnish viitenumero (4-20 digits, weights 7-3-1 from the right). Norwegian KID and Swedish OCR are RECOGNISED but never judged: they answer valid: null with status unverifiable_without_creditor_config, because modulus type and length are configured per creditor account by the beneficiary bank and are not a property of the string. NEVER relay those to a user as \"invalid\" — say the check needs the creditor bank configuration. AMBIGUITY: only a leading \"RF\" and a 27-digit length pin a scheme down. A bare 12-digit string is both a Belgian OGM and a legal Finnish length, so the more specific reading is returned and the other appears in also_valid_as. Pass reference_type when you know the country. THE PAIRING RULE — the part no checksum library reproduces: pass an iban and you also get a pairing verdict. Per the Swiss Implementation Guidelines a QRR reference may ONLY be used with a QR-IBAN (institution identifier in the SIX range 30000-31999), and an ISO 11649 reference may NOT be used with one. Outside CH and LI, pairing is not_applicable — there is no QR-IBAN to pair against — and that does not affect the reference's own checksum verdict. IMPORTANT: valid and pairing are INDEPENDENT. A reference can be arithmetically valid and still illegal on that account. Read both, and relay source/as_of — they are what makes the verdict auditable. FREE: the checksums are published commodities. The paid surface is POST /v1/iban/validate, which returns this same pairing block with the full IBAN enrichment. COST: $0 per call.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "reference"
            ],
            "properties": {
              "iban": {
                "type": "string",
                "description": "Optional creditor IBAN — supply it to get the pairing verdict"
              },
              "reference": {
                "type": "string",
                "description": "The reference as printed; spaces, slashes and the +++…+++ wrapper are stripped"
              },
              "reference_type": {
                "type": "string",
                "description": "Optional hint: rf | scor | qrr | ogm | vcs | viitenumero | kid | ocr"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "reference",
              "scheme",
              "valid",
              "status",
              "source",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "What was checked, and what was not."
              },
              "as_of": {
                "type": "string",
                "description": "YYYY-MM of that document."
              },
              "valid": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "null means the scheme was recognised and cannot be checked without the creditor bank configuration. Never report null as false."
              },
              "scheme": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "rf | qrr | ogm | viitenumero | kid | ocr, or null when nothing matched."
              },
              "source": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The document publishing the rule. Null only when no scheme matched. Relay it."
              },
              "status": {
                "type": "string",
                "description": "checked | unverifiable_without_creditor_config | unrecognised"
              },
              "pairing": {
                "type": "string",
                "description": "Present only when an iban was supplied: ok | qrr_requires_qr_iban | scor_forbidden_with_qr_iban | not_applicable"
              },
              "reference": {
                "type": "string",
                "description": "Normalized: uppercase, separators removed."
              },
              "also_valid_as": {
                "type": "object",
                "required": [
                  "scheme",
                  "valid"
                ],
                "properties": {
                  "valid": {
                    "type": "boolean"
                  },
                  "scheme": {
                    "type": "string"
                  },
                  "check_digit_expected": {
                    "type": "string"
                  }
                },
                "description": "The second reading of an ambiguous string, with its own verdict.",
                "additionalProperties": false
              },
              "pairing_as_of": {
                "type": "string"
              },
              "pairing_source": {
                "type": "string",
                "description": "The document publishing the pairing rule — a DIFFERENT one from source."
              },
              "check_digit_expected": {
                "type": "string",
                "description": "A STRING, so a two-digit value beginning with zero survives (OGM remainder 3 is \"03\", remainder 0 is \"97\")."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Validate Payment Reference",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "check_swiss_qr_bill",
          "title": "Check Swiss QR-bill Payload",
          "description": "Check a Swiss QR-bill payload, the text a QR-bill's code carries (starts with SPC), rule by rule, each finding citing the SIX document it comes from. USE WHEN: an agent, an ERP or an accounting tool holds a scanned or generated QR-bill and must know before paying or issuing it whether it is well-formed, whether the reference type matches the IBAN (QRR needs a QR-IBAN, IID 30000-31999), and above all whether the creditor and debtor addresses are STRUCTURED (type S) or still COMBINED (type K): type K has not been permitted since 21.11.2025, and the banks guarantee payment of a type K QR-bill only until the end of September 2026. DO NOT USE to learn which bank holds the account or its payment-rail participation: that is the paid validate_iban. RETURNS: { valid, ready_for_2026_11_14, creditor_iban { value, valid, country, qr_iban, iid }, creditor { present, address, structured, sps_check, proposed_structured }, ultimate_debtor, amount, currency, reference { type, value, valid, note }, findings [{ code, severity, field, detail, source }], next_steps, source }. A combined address comes back with proposed_structured, the S-type fields derived from the combined lines, to relay as a fix. For a type S address in CH or LI, sps_check.postcode_locality compares postcode and town with the official directory of localities of swisstopo (©swisstopo, version date in as_of). A warning (postcode_town_mismatch, postcode_other_country, postcode_not_listed) comes back when the directory lists the postcode for other towns or in the other country, or lists neither the postcode nor the town in that postal area; never an error, and valid does not change. A postcode missing from the directory, while the town is listed there under another postcode of the same postal area (likely a post-office box postcode), comes back not_verifiable, without a warning: the absence of a warning does not mean the pair was verified. IMPORTANT: relay each finding's source string. COST: $0 per call, on every surface.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "payload"
            ],
            "properties": {
              "payload": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1,
                "description": "The Swiss QR Code text with real line breaks: SPC, 0200, 1, IBAN, creditor (7 lines), ultimate creditor (7 empty lines), amount, currency, ultimate debtor (7 lines), reference type, reference, message, EPD, optional billing information and alternative schemes."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "valid",
              "ready_for_2026_11_14",
              "qr_type",
              "version",
              "coding",
              "creditor_iban",
              "creditor",
              "ultimate_creditor_empty",
              "amount",
              "currency",
              "ultimate_debtor",
              "reference",
              "unstructured_message",
              "trailer",
              "billing_information",
              "alternative_schemes",
              "findings",
              "next_steps",
              "source"
            ],
            "properties": {
              "valid": {
                "type": "boolean",
                "description": "True when no finding has severity error."
              },
              "amount": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "coding": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "qr_type": {
                "type": "string"
              },
              "trailer": {
                "type": "string"
              },
              "version": {
                "type": "string"
              },
              "creditor": {
                "type": "object",
                "required": [
                  "present",
                  "address",
                  "structured",
                  "sps_check",
                  "proposed_structured"
                ],
                "properties": {
                  "address": {
                    "type": "object",
                    "required": [
                      "type",
                      "name",
                      "line1",
                      "line2",
                      "postal_code",
                      "town",
                      "country"
                    ],
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "town": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string",
                        "description": "AdrTp as carried: S (structured), K (combined) or empty."
                      },
                      "line1": {
                        "type": "string",
                        "description": "StrtNm for type S, AdrLine1 for type K."
                      },
                      "line2": {
                        "type": "string",
                        "description": "BldgNb for type S, AdrLine2 (postal code and town) for type K."
                      },
                      "country": {
                        "type": "string"
                      },
                      "postal_code": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "present": {
                    "type": "boolean"
                  },
                  "sps_check": {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "scheme",
                          "conforms",
                          "findings",
                          "postcode_locality",
                          "note"
                        ],
                        "properties": {
                          "note": {
                            "type": "string"
                          },
                          "scheme": {
                            "type": "string"
                          },
                          "conforms": {
                            "type": "boolean"
                          },
                          "findings": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "rule",
                                "verdict",
                                "detail",
                                "source"
                              ],
                              "properties": {
                                "rule": {
                                  "type": "string"
                                },
                                "detail": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "verdict": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "postcode_locality": {
                            "anyOf": [
                              {
                                "type": "object",
                                "required": [
                                  "status",
                                  "localities",
                                  "detail",
                                  "source",
                                  "as_of"
                                ],
                                "properties": {
                                  "as_of": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "Version date of the directory (YYYY-MM-DD)."
                                  },
                                  "detail": {
                                    "type": "string",
                                    "description": "What was compared and what came out of it."
                                  },
                                  "source": {
                                    "type": "string",
                                    "description": "The directory, its version and the credit ©swisstopo that its terms require."
                                  },
                                  "status": {
                                    "type": "string",
                                    "description": "match | town_mismatch | other_country | postcode_not_listed | not_verifiable | directory_unavailable. not_verifiable: the postcode is not in the directory, which lists territory only, while the town is listed under other postcodes of the same postal area (a post-office box or business postcode is likely)."
                                  },
                                  "localities": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "required": [
                                        "name",
                                        "municipality",
                                        "canton",
                                        "country"
                                      ],
                                      "properties": {
                                        "name": {
                                          "type": "string",
                                          "description": "The locality as the directory writes it."
                                        },
                                        "canton": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "null in Liechtenstein."
                                        },
                                        "country": {
                                          "type": "string",
                                          "description": "CH | LI"
                                        },
                                        "municipality": {
                                          "type": "string"
                                        }
                                      },
                                      "additionalProperties": false
                                    },
                                    "description": "The entries the directory gives for this postcode; empty when it has none."
                                  }
                                },
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Swiss and Liechtenstein addresses with a postcode and a town: whether the two go together in the official directory of localities of swisstopo. Informative, beside the format verdicts: it does not change conforms or valid. The street is not checked. null for any other address."
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The SPS structured-address verdicts for a type S address; null otherwise."
                  },
                  "structured": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "true = type S, false = type K (combined), null = absent or invalid type."
                  },
                  "proposed_structured": {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "confidence",
                          "note"
                        ],
                        "properties": {
                          "ctry": {
                            "type": "string"
                          },
                          "note": {
                            "type": "string"
                          },
                          "pst_cd": {
                            "type": "string"
                          },
                          "twn_nm": {
                            "type": "string"
                          },
                          "bldg_nb": {
                            "type": "string"
                          },
                          "strt_nm": {
                            "type": "string"
                          },
                          "confidence": {
                            "type": "string",
                            "description": "high | low"
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "For a combined (K) address: the type S fields derived from the combined lines."
                  }
                },
                "additionalProperties": false
              },
              "currency": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "findings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "code",
                    "severity",
                    "field",
                    "detail",
                    "source"
                  ],
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "Stable identifier, safe to branch on."
                    },
                    "field": {
                      "type": "string"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string",
                      "description": "The SIX document the rule comes from. Relay it."
                    },
                    "severity": {
                      "type": "string",
                      "description": "error | warning"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "reference": {
                "type": "object",
                "required": [
                  "type",
                  "value",
                  "valid",
                  "note"
                ],
                "properties": {
                  "note": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "description": "QRR | SCOR | NON as carried."
                  },
                  "valid": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "value": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "next_steps": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "creditor_iban": {
                "type": "object",
                "required": [
                  "value",
                  "valid",
                  "country",
                  "qr_iban",
                  "iid"
                ],
                "properties": {
                  "iid": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "valid": {
                    "type": "boolean"
                  },
                  "value": {
                    "type": "string"
                  },
                  "country": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "qr_iban": {
                    "type": "boolean",
                    "description": "IID in 30000-31999, which requires reference type QRR."
                  }
                },
                "additionalProperties": false
              },
              "ultimate_debtor": {
                "type": "object",
                "required": [
                  "present",
                  "address",
                  "structured",
                  "sps_check",
                  "proposed_structured"
                ],
                "properties": {
                  "address": {
                    "type": "object",
                    "required": [
                      "type",
                      "name",
                      "line1",
                      "line2",
                      "postal_code",
                      "town",
                      "country"
                    ],
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "town": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string",
                        "description": "AdrTp as carried: S (structured), K (combined) or empty."
                      },
                      "line1": {
                        "type": "string",
                        "description": "StrtNm for type S, AdrLine1 for type K."
                      },
                      "line2": {
                        "type": "string",
                        "description": "BldgNb for type S, AdrLine2 (postal code and town) for type K."
                      },
                      "country": {
                        "type": "string"
                      },
                      "postal_code": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "present": {
                    "type": "boolean"
                  },
                  "sps_check": {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "scheme",
                          "conforms",
                          "findings",
                          "postcode_locality",
                          "note"
                        ],
                        "properties": {
                          "note": {
                            "type": "string"
                          },
                          "scheme": {
                            "type": "string"
                          },
                          "conforms": {
                            "type": "boolean"
                          },
                          "findings": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "rule",
                                "verdict",
                                "detail",
                                "source"
                              ],
                              "properties": {
                                "rule": {
                                  "type": "string"
                                },
                                "detail": {
                                  "type": "string"
                                },
                                "source": {
                                  "type": "string"
                                },
                                "verdict": {
                                  "type": "string"
                                }
                              },
                              "additionalProperties": false
                            }
                          },
                          "postcode_locality": {
                            "anyOf": [
                              {
                                "type": "object",
                                "required": [
                                  "status",
                                  "localities",
                                  "detail",
                                  "source",
                                  "as_of"
                                ],
                                "properties": {
                                  "as_of": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "Version date of the directory (YYYY-MM-DD)."
                                  },
                                  "detail": {
                                    "type": "string",
                                    "description": "What was compared and what came out of it."
                                  },
                                  "source": {
                                    "type": "string",
                                    "description": "The directory, its version and the credit ©swisstopo that its terms require."
                                  },
                                  "status": {
                                    "type": "string",
                                    "description": "match | town_mismatch | other_country | postcode_not_listed | not_verifiable | directory_unavailable. not_verifiable: the postcode is not in the directory, which lists territory only, while the town is listed under other postcodes of the same postal area (a post-office box or business postcode is likely)."
                                  },
                                  "localities": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "required": [
                                        "name",
                                        "municipality",
                                        "canton",
                                        "country"
                                      ],
                                      "properties": {
                                        "name": {
                                          "type": "string",
                                          "description": "The locality as the directory writes it."
                                        },
                                        "canton": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "null in Liechtenstein."
                                        },
                                        "country": {
                                          "type": "string",
                                          "description": "CH | LI"
                                        },
                                        "municipality": {
                                          "type": "string"
                                        }
                                      },
                                      "additionalProperties": false
                                    },
                                    "description": "The entries the directory gives for this postcode; empty when it has none."
                                  }
                                },
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Swiss and Liechtenstein addresses with a postcode and a town: whether the two go together in the official directory of localities of swisstopo. Informative, beside the format verdicts: it does not change conforms or valid. The street is not checked. null for any other address."
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The SPS structured-address verdicts for a type S address; null otherwise."
                  },
                  "structured": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "true = type S, false = type K (combined), null = absent or invalid type."
                  },
                  "proposed_structured": {
                    "anyOf": [
                      {
                        "type": "object",
                        "required": [
                          "confidence",
                          "note"
                        ],
                        "properties": {
                          "ctry": {
                            "type": "string"
                          },
                          "note": {
                            "type": "string"
                          },
                          "pst_cd": {
                            "type": "string"
                          },
                          "twn_nm": {
                            "type": "string"
                          },
                          "bldg_nb": {
                            "type": "string"
                          },
                          "strt_nm": {
                            "type": "string"
                          },
                          "confidence": {
                            "type": "string",
                            "description": "high | low"
                          }
                        },
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "For a combined (K) address: the type S fields derived from the combined lines."
                  }
                },
                "additionalProperties": false
              },
              "alternative_schemes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "billing_information": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ready_for_2026_11_14": {
                "type": "boolean",
                "description": "valid AND every present address is structured (type S). The name is kept for compatibility and is not a deadline: type K has not been permitted since 21.11.2025, and the banks guarantee payment of a type K QR-bill only until the end of September 2026."
              },
              "unstructured_message": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ultimate_creditor_empty": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Check Swiss QR-bill Payload",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "check_postal_address",
          "title": "Check ISO 20022 Postal Address",
          "description": "Check a structured ISO 20022 postal address against a payment rail's published address rules, rule by rule, each verdict citing the document it comes from. USE WHEN: assembling a payment instruction (pain.001, a Fedwire message, a T2 transfer) with a creditor or debtor address, to check conformity with the named document BEFORE submitting. Timetables differ: SPS 2026 in force 14 Nov 2026 requires town and country whenever an address is given, but SIC does not validate addresses and each bank decides what it still accepts. Fedwire moved its release to November 2027. The fetched T2 R2026.NOV does not forbid an AddressLine-only address; the MyStandards usage guideline could not be read. DO NOT USE to verify that a street or a building exists: the findings check conformity with the message format rules, and no street is looked up. For a Swiss or Liechtenstein address (ctry CH or LI, with pst_cd and twn_nm), the separate postcode_locality block says whether postcode and town go together in the official directory of localities of swisstopo (©swisstopo, version date in as_of); it is informative and does not change conforms. SCHEMES: 'sps' (Swiss Payment Standards, SIX), 'hvps_plus' (HVPS+ / T2, ECB), 'fedwire' (Federal Reserve). There is deliberately NO 'cbpr+' scheme: that guideline sits behind swift.com, unreachable to automated readers, and a conformity boolean quoting an unread document would be a guess dressed as a verdict — the note field restates this on every answer. VERDICTS: pass, fail, and not_applicable — the last marks a rule whose precondition is not met and never counts as a pass. conforms is true when no finding failed. IMPORTANT: relay each finding's source string — it names the exact document, version and validity date the rule is quoted from. They are what makes the verdict auditable. FREE: the rules are published commodities. The paid surface is the postal_address block that /v1/bic and /v1/iban/validate return for the resolved institution. COST: $0 per call, on every surface.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "scheme",
              "address"
            ],
            "properties": {
              "scheme": {
                "enum": [
                  "sps",
                  "hvps_plus",
                  "fedwire"
                ],
                "type": "string",
                "description": "Which rail's rules to check against: sps | hvps_plus | fedwire"
              },
              "address": {
                "type": "object",
                "properties": {
                  "ctry": {
                    "type": "string",
                    "description": "Ctry — ISO 3166-1 alpha-2 country code"
                  },
                  "adr_tp": {
                    "type": "string",
                    "description": "AdrTp — address type (SPS forbids sending it)"
                  },
                  "pst_cd": {
                    "type": "string",
                    "description": "PstCd — postal code"
                  },
                  "twn_nm": {
                    "type": "string",
                    "description": "TwnNm — town name"
                  },
                  "bldg_nb": {
                    "type": "string",
                    "description": "BldgNb — building number"
                  },
                  "strt_nm": {
                    "type": "string",
                    "description": "StrtNm — street name"
                  },
                  "adr_line": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "AdrLine — free-text lines of the hybrid address"
                  }
                },
                "description": "The ISO 20022 PostalAddress under test, in ISO tag vocabulary (snake_cased).",
                "additionalProperties": false
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "scheme",
              "conforms",
              "findings",
              "postcode_locality",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "Why 'cbpr+' is not on the menu. Served on every answer."
              },
              "scheme": {
                "type": "string",
                "description": "sps | hvps_plus | fedwire — the rule set that was applied."
              },
              "conforms": {
                "type": "boolean",
                "description": "True when no finding failed. not_applicable findings never count against it."
              },
              "findings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "rule",
                    "verdict",
                    "detail",
                    "source"
                  ],
                  "properties": {
                    "rule": {
                      "type": "string",
                      "description": "Stable identifier, safe to branch on."
                    },
                    "detail": {
                      "type": "string",
                      "description": "What was looked at and what was concluded."
                    },
                    "source": {
                      "type": "string",
                      "description": "The document the rule comes from, with its date. Relay it."
                    },
                    "verdict": {
                      "type": "string",
                      "description": "pass | fail | not_applicable"
                    }
                  },
                  "additionalProperties": false
                },
                "description": "One entry per rule of the scheme, in a stable order."
              },
              "postcode_locality": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "status",
                      "localities",
                      "detail",
                      "source",
                      "as_of"
                    ],
                    "properties": {
                      "as_of": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Version date of the directory (YYYY-MM-DD)."
                      },
                      "detail": {
                        "type": "string",
                        "description": "What was compared and what came out of it."
                      },
                      "source": {
                        "type": "string",
                        "description": "The directory, its version and the credit ©swisstopo that its terms require."
                      },
                      "status": {
                        "type": "string",
                        "description": "match | town_mismatch | other_country | postcode_not_listed | not_verifiable | directory_unavailable. not_verifiable: the postcode is not in the directory, which lists territory only, while the town is listed under other postcodes of the same postal area (a post-office box or business postcode is likely)."
                      },
                      "localities": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "name",
                            "municipality",
                            "canton",
                            "country"
                          ],
                          "properties": {
                            "name": {
                              "type": "string",
                              "description": "The locality as the directory writes it."
                            },
                            "canton": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "null in Liechtenstein."
                            },
                            "country": {
                              "type": "string",
                              "description": "CH | LI"
                            },
                            "municipality": {
                              "type": "string"
                            }
                          },
                          "additionalProperties": false
                        },
                        "description": "The entries the directory gives for this postcode; empty when it has none."
                      }
                    },
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Swiss and Liechtenstein addresses with a postcode and a town: whether the two go together in the official directory of localities of swisstopo. Informative, beside the format verdicts: it does not change conforms or valid. The street is not checked. null for any other address."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Check ISO 20022 Postal Address",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "lookup_ch_clearing",
          "title": "Swiss Clearing Lookup",
          "description": "Resolve a Swiss BC-Nummer / IID (1 to 5 digits) into the underlying institution. USE WHEN: the user mentions a Swiss bank by BC-Nummer or IID, pastes a CH or LI IBAN clearing code, asks routing details for a Swiss instant transfer (SIC, euroSIC), asks about QR-bill QR-IID resolution, or needs to classify a Swiss financial institution (bank vs PFS vs SIC-only participant). EVERY IID OF THE SIX BANKMASTER, with its full payment-rail participation (SIC, RTGS CHF, Instant Payments CHF, euroSIC, LSV+/BDD) plus QR-IID allocation, not just a name lookup. BACKED BY: 1,100+ SIX BankMaster entries (Swiss official source, re-read weekly). RETURNS: institution { name, type, iid_type, headquarters_iid }, address, bic, payment_services { sic, rtgs_chf, instant_payments_chf, eurosic, lsv_bdd_chf, lsv_bdd_eur }, sic_iid, qr_iid, valid_on. Only relevant for CH and LI accounts. COST: $0.003 per call.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "iid"
            ],
            "properties": {
              "iid": {
                "type": "string",
                "description": "Swiss IID (1-5 digit number)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "bic": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "BIC if mapped."
              },
              "iid": {
                "type": "string",
                "description": "Normalized 5-digit BC-Nummer."
              },
              "note": {
                "type": "string"
              },
              "error": {
                "type": "string"
              },
              "found": {
                "type": "boolean"
              },
              "qr_iid": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "QR-bill enabled IID."
              },
              "address": {
                "type": "object",
                "required": [
                  "street",
                  "building_number",
                  "post_code",
                  "town",
                  "country"
                ],
                "properties": {
                  "town": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "street": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "country": {
                    "type": "string"
                  },
                  "post_code": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "building_number": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "message": {
                "type": "string"
              },
              "qr_iids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Every QR-IID SIX allocates to the institution, present only when there is more than one; qr_iid carries the lowest."
              },
              "sic_iid": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "valid_on": {
                "type": "string"
              },
              "cost_usdc": {
                "type": "number",
                "description": "What THIS call was billed. Zero on the free MCP tier."
              },
              "is_qr_iid": {
                "type": "boolean",
                "description": "Present (true) only when the IID asked about is a QR-IID (SIX QR-bill range 30000-31999); iid then carries the standard IID of the institution and qr_iid the QR-IID asked about."
              },
              "institution": {
                "type": "object",
                "required": [
                  "name",
                  "type",
                  "iid_type",
                  "headquarters_iid"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "description": "bank | cantonal_bank | postfinance | raiffeisen | central_bank | foreign_participant"
                  },
                  "iid_type": {
                    "type": "string",
                    "description": "headquarters | branch | other"
                  },
                  "headquarters_iid": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "qr_iid_source": {
                "anyOf": [
                  {
                    "enum": [
                      "register",
                      "headquarters"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "How qr_iid was obtained. register = SIX BankMaster publishes this pairing; headquarters = inherited from the head office (headquarters_iid), an inference and not a published SIX pairing. Null when qr_iid is null."
              },
              "list_price_usdc": {
                "type": "number",
                "description": "Catalogue price of the same call on the paid REST/x402 route."
              },
              "redirected_from": {
                "type": "string"
              },
              "state_guarantee": {
                "type": "object",
                "required": [
                  "guaranteed",
                  "canton",
                  "source",
                  "url",
                  "as_of"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "The text that was read."
                  },
                  "note": {
                    "type": "string",
                    "description": "Present where the guarantee ended (BEKB, BCGE: what the law kept and until when) or where the law has none (BCV)."
                  },
                  "as_of": {
                    "type": "string",
                    "description": "The day the text was read (YYYY-MM-DD)."
                  },
                  "canton": {
                    "type": "string",
                    "description": "Two-letter canton code."
                  },
                  "source": {
                    "type": "string",
                    "description": "The law, its number in the cantonal collection, and the article. The exclusions the law writes (for example subordinated debt) are in that law; where they sit in another article, that article is cited too."
                  },
                  "guaranteed": {
                    "type": "boolean",
                    "description": "True when the cantonal law makes the canton liable for the bank's liabilities where the bank's own funds fall short (Staatsgarantie, garantie de l'État)."
                  }
                },
                "description": "Present for the 24 Swiss cantonal banks only, matched by head-office IID; a branch or QR-IID takes its head office's entry. A description of the institution, not an assessment of the bank or of any account.",
                "additionalProperties": false
              },
              "payment_services": {
                "type": "object",
                "required": [
                  "sic",
                  "rtgs_chf",
                  "instant_payments_chf",
                  "eurosic",
                  "lsv_bdd_chf",
                  "lsv_bdd_eur"
                ],
                "properties": {
                  "sic": {
                    "type": "boolean",
                    "description": "Swiss Interbank Clearing."
                  },
                  "eurosic": {
                    "type": "boolean"
                  },
                  "rtgs_chf": {
                    "type": "boolean"
                  },
                  "lsv_bdd_chf": {
                    "type": "boolean"
                  },
                  "lsv_bdd_eur": {
                    "type": "boolean"
                  },
                  "instant_payments_chf": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Swiss Clearing Lookup",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "send_feedback",
          "title": "Send Feedback to IBANforge",
          "description": "Report a problem or a need directly to the IBANforge operators: incorrect validation result, stale or missing BIC/bank data, latency, or anything blocking you from using or PAYING for the service (missing network, unclear pricing, quota shape). USE WHEN: a result looks wrong, data you need is missing, or you hit a wall (quota, payment, capability) and want it fixed. This tool is free and does NOT count against the free allowance — it works even after the allowance is spent. A human reads every report.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "error_type",
              "notes"
            ],
            "properties": {
              "got": {
                "type": "string",
                "maxLength": 1000,
                "description": "What you received instead (for data errors)."
              },
              "agent": {
                "type": "string",
                "maxLength": 120,
                "description": "Which agent/model is reporting, e.g. \"claude-sonnet-5 via MCP\"."
              },
              "notes": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 3,
                "description": "What happened, what you needed, or what blocked you — free text."
              },
              "contact": {
                "type": "string",
                "maxLength": 255,
                "description": "Where we may answer you (e-mail) — optional, reports can be anonymous."
              },
              "endpoint": {
                "type": "string",
                "maxLength": 200,
                "description": "Endpoint or tool concerned, e.g. /v1/iban/batch."
              },
              "expected": {
                "type": "string",
                "maxLength": 1000,
                "description": "What you expected (for data errors)."
              },
              "error_type": {
                "enum": [
                  "wrong_validation",
                  "stale_bic",
                  "missing_data",
                  "incorrect_classification",
                  "latency",
                  "other"
                ],
                "type": "string",
                "description": "Category of the report. Use \"other\" for product feedback, pricing/payment blockers or feature needs."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "ok",
              "id"
            ],
            "properties": {
              "id": {
                "type": "number",
                "description": "Report id — check status at GET /v1/feedback/{id}."
              },
              "ok": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Send Feedback to IBANforge",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "request_api_key",
          "title": "Request an IBANforge API key",
          "description": "Start the process that gives your human a free IBANforge API key, without any e-mail address. The key does not unlock this session: it works once your human puts it in the MCP client configuration and reconnects, or sends it to the REST API, so tell them where it goes when you hand it over: `config_line` (returned by poll_api_key) for Claude Code with the npm package; for the hosted server https://api.ibanforge.com/mcp, the header \"Authorization: Bearer <key>\", which Claude and Claude Desktop take under Request headers when the custom connector is added (a beta section Anthropic does not show to every account, and an existing connector has to be removed and added again to take a key); ChatGPT sends no key to a connector, so in ChatGPT the key serves on the REST API only. USE WHEN: you used up the free allowance, a call answers 402, or your human is about to run more than a handful of validations. WHAT YOU MUST DO WITH THE RESULT: read `status` first — `ok` means a code was issued, anything else means no code exists and `display_to_human` tells you and your human what to do instead. On `ok`, show `display_to_human` to your human VERBATIM (the user_code and the link) and say, in your own words, that opening the link and approving takes about fifteen seconds and asks for nothing. Do NOT open the link yourself, do NOT fill anything in on their behalf, and do NOT invent an e-mail address: the page gives a key with no address at all, and your human may add one if THEY choose. Then call poll_api_key. This tool is free and does NOT count against the free allowance — it works even after the allowance is spent.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "reason": {
                "type": "string",
                "maxLength": 200,
                "description": "Optional. What the key is for, shown to the human on the approval page."
              },
              "client_name": {
                "type": "string",
                "maxLength": 60,
                "description": "Optional. Who is asking, shown to the human on the approval page."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "status",
              "user_code",
              "verification_uri",
              "verification_uri_complete",
              "expires_in",
              "interval",
              "display_to_human"
            ],
            "properties": {
              "status": {
                "enum": [
                  "ok",
                  "device_rate_limited",
                  "device_unavailable"
                ],
                "type": "string",
                "description": "ok means a code was issued. Anything else: read display_to_human and fall back."
              },
              "interval": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Minimum seconds between two poll_api_key calls."
              },
              "user_code": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Show this to the human, exactly as written, e.g. WDJB-MJHT."
              },
              "expires_in": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Seconds until the code stops working."
              },
              "display_to_human": {
                "type": "string",
                "description": "A ready-made block of text to show verbatim. Do not paraphrase it."
              },
              "verification_uri": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The page the human opens. Never open it yourself."
              },
              "verification_uri_complete": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Same page with the code pre-filled. This is the one to show."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Request an IBANforge API key",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "poll_api_key",
          "title": "Collect the approved IBANforge API key",
          "description": "Collect the API key once a human has approved the request opened by request_api_key. USE WHEN: you have called request_api_key and shown the code to your human. HOW TO CALL IT: leave `device_code` empty to reuse the last request from this session. The server usually waits up to thirty seconds before answering, and sometimes answers at once when it is busy — either way, calling it once per minute is enough, never in a tight loop. WHAT THE ANSWERS MEAN: `authorization_pending` is normal and means nobody has approved yet — wait `retry_in_seconds` and call again; `approved` carries the key ONCE and never again, so hand it to your human immediately together with `config_line`, or the header \"Authorization: Bearer <key>\" for the hosted server; `access_denied` means somebody refused — tell your human, ask THEM whether to try again, and open at most ONE more request; `expired_token` means the code timed out — you may call request_api_key ONE more time, and if that expires too, stop and keep using the keyless allowance or x402; `invalid_grant` means this code can no longer be used at all — stop. This tool is free and does NOT count against the free allowance.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "device_code": {
                "type": "string",
                "description": "Optional. Leave it empty to reuse the last request from this session."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "status",
              "api_key",
              "key_prefix",
              "tier",
              "monthly_limit",
              "email",
              "retry_in_seconds",
              "expires_in",
              "config_line",
              "message"
            ],
            "properties": {
              "tier": {
                "anyOf": [
                  {
                    "enum": [
                      "anonymous",
                      "email",
                      "claimed",
                      "paid"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "anonymous = the entry allowance, email/claimed/paid = the raised one."
              },
              "email": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Absent on the anonymous tier: no address was ever given."
              },
              "status": {
                "enum": [
                  "authorization_pending",
                  "approved",
                  "access_denied",
                  "expired_token",
                  "invalid_grant"
                ],
                "type": "string",
                "description": "authorization_pending is normal: wait `retry_in_seconds` and call again."
              },
              "api_key": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Present exactly once, on the first approved poll."
              },
              "message": {
                "type": "string",
                "description": "One sentence for the human."
              },
              "expires_in": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "key_prefix": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "config_line": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The exact command line to give the human. Do not run it yourself."
              },
              "monthly_limit": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "retry_in_seconds": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Collect the approved IBANforge API key",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "countries",
          "uri": "ibanforge://countries",
          "mimeType": "application/json",
          "description": "List of all 89 countries supported by IBANforge with IBAN length, SEPA membership, VoP status, and country risk classification."
        },
        {
          "name": "pricing",
          "uri": "ibanforge://pricing",
          "mimeType": "application/json",
          "description": "Per-call pricing for IBANforge API endpoints (USDC on Base L2 via x402 protocol)."
        }
      ],
      "prompts": [
        {
          "name": "validate_and_explain",
          "description": "Validate an IBAN and generate a human-readable explanation suitable for non-technical users.",
          "arguments": [
            {
              "name": "iban",
              "required": true,
              "description": "The IBAN to validate and explain"
            }
          ]
        }
      ]
    },
    "instructions": "Start with validate_iban on any IBAN-looking string (e.g. DE89370400440532013000) — one call returns validity, the issuing bank + BIC, virtual-IBAN/EMI detection, SEPA reachability and VoP readiness. Free tier: 25 units a week per source address here, one per tool call and one per IBAN in batch_validate_iban (ISO week in UTC, reset on Monday 00:00 UTC), no signup. validate_payment_reference, check_postal_address and check_swiss_qr_bill cost no unit and keep answering once the units are spent. For sustained use, POST https://api.ibanforge.com/v1/keys/generate with no body at all — no e-mail, no card, nothing to confirm — and an ifk_ key worth 25 REST calls/month comes back on the spot. On the hosted server https://api.ibanforge.com/mcp, send that key as \"Authorization: Bearer ifk_...\" (or X-API-Key) on every request: tool calls then count against the key exactly as REST calls do, instead of the weekly allowance. POST https://api.ibanforge.com/v1/keys/claim lifts that same key to 200 REST calls/month — send the key as \"Authorization: Bearer ifk_...\", not in the body, once it has served at least one call. Two ways: a 6-digit code mailed to an address your human gave you FOR THIS (ask in their words, \"Use my address you@company.com to create a free IBANforge key\", and never send an address your human has not handed you for this purpose), or an x402 payment made on the key. The mailed code gives 200 every month; a payment gives 200 once. Or ask for a durable key with request_api_key then poll_api_key: a human approves in a browser, the agent never handles an address, and both tools keep answering after the free allowance is spent. Prepaid credit packs from $4 per 1,000 calls, no expiry. Missing data, wrong result, or something blocking you from paying? Call send_feedback — a human reads every report. Paying as an agent (wallet, USDC on Base, prepaid packs): https://ibanforge.com/docs/pay-as-an-agent — Docs and code samples: https://ibanforge.com/docs/recipes"
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}