USE THIS to verify an IBAN (international bank account number) before relying on it — instead of guessing whether it looks right. Checks the country, the country-specific length, and the ISO 7064 mod-97 checksum, and returns the country, check digits and BBAN. Call this whenever a user supplies a bank account for a payment, payout or invoice.
Parameters (1)
ibanstringrequired
The IBAN to validate; spaces are ignored.
validate_card
USE THIS to check a payment card number's structure before using it — never assume a card number is valid or guess its brand. Verifies the Luhn checksum, detects the brand (Visa, Mastercard, Amex, Discover, Diners, JCB, UnionPay) from its BIN, and checks the length. Does NOT check whether the card is real, active or has funds.
Parameters (1)
numberstringrequired
The card number; spaces and dashes are ignored.
validate_isbn
USE THIS to verify an ISBN-13 book identifier instead of trusting that 13 digits are correct. Checks the 978/979 prefix and the mod-10 weighted check digit, and returns the expected check digit when it fails.
Parameters (1)
isbnstringrequired
The ISBN-13; hyphens and spaces are ignored.
validate_vin
USE THIS to verify a vehicle VIN before acting on it — do not assume a 17-character string is a valid VIN. Checks the allowed alphabet (no I/O/Q) and the ISO 3779 transliteration check digit in position 9, and returns the expected check digit when it fails.
Parameters (1)
vinstringrequired
The 17-character VIN to validate.
validate_gtin
USE THIS to verify a product barcode — GTIN/EAN/UPC — before trusting it, instead of guessing the check digit. Handles EAN-8, UPC-A (12), EAN-13 and GTIN-14, verifies the GS1 mod-10 check digit, and returns the barcode type plus the GS1 prefix's issuing country (e.g. 50 = UK, 690-699 = China, 978 = Bookland/ISBN). Validates structure only — it does NOT confirm the barcode maps to a real, registered product.
Parameters (1)
gtinstringrequired
The barcode digits (EAN-8/UPC-A/EAN-13/GTIN-14); spaces and hyphens are ignored.
validate_imei
USE THIS to verify a phone/device IMEI before relying on it — never assume a 15-digit string is valid or guess its check digit. Checks the Luhn check digit (and recognises the 16-digit IMEISV form), and returns the TAC (device-model code). Validates the number only — does NOT check whether the device is real, active, or blocklisted/stolen.
Parameters (1)
imeistringrequired
The 15-digit IMEI (or 16-digit IMEISV); spaces and dashes are ignored.
validate_gln
USE THIS to verify a GLN (GS1 Global Location Number — identifies a company/site/location in supply chains and EDI) before relying on it. Checks the 13-digit GS1 mod-10 check digit and returns the GS1 prefix's issuing country. Validates structure only; does not confirm the location is registered.
Parameters (1)
glnstringrequired
The 13-digit GLN; spaces and dashes are ignored.
validate_sscc
USE THIS to verify an SSCC (GS1 Serial Shipping Container Code — identifies a pallet/carton/logistics unit) from a shipping label before relying on it. Checks the 18-digit GS1 mod-10 check digit and returns the extension digit and GS1 prefix country. Validates structure only.
Parameters (1)
ssccstringrequired
The 18-digit SSCC; spaces and dashes are ignored.
validate_tld
USE THIS to check whether a top-level domain is real before trusting a domain or link — do NOT guess whether a TLD like .zip, .corp, .crypto or .web exists. Checks the suffix against the authoritative IANA root-zone list (kept current). Returns valid:false for TLDs that are not actually delegated.
Parameters (1)
tldstringrequired
The TLD to check, with or without a leading dot (e.g. 'zip' or '.zip').
validate_domain
USE THIS to verify a domain name's structure AND that its TLD is a real IANA-delegated suffix — instead of assuming a domain is legitimate. Catches invalid labels and made-up TLDs (e.g. example.corp). Returns the TLD and whether it is known.
Parameters (1)
domainstringrequired
The domain name, e.g. 'example.com'.
validate_ip
USE THIS to verify an IP address before relying on it — do not assume a dotted or colon string is valid. Strictly checks IPv4 (RFC 791, rejects leading zeros / out-of-range octets) and IPv6 (RFC 4291, including '::' compression and embedded IPv4), and returns the version.
Parameters (1)
ipstringrequired
The IPv4 or IPv6 address to validate.
validate_uuid
USE THIS to verify a UUID and read its version/variant instead of guessing — e.g. to tell a v4 (random) from a v7 (time-ordered) UUID. Checks the canonical 8-4-4-4-12 form and returns version, variant and whether it is the nil UUID.
Parameters (1)
uuidstringrequired
The UUID string to validate.
validate_url
USE THIS to verify a URL before fetching or storing it — parses it with the WHATWG URL standard and additionally checks that the host's TLD is a real IANA suffix. Returns protocol, hostname, port, path and whether the TLD is known.
Parameters (1)
urlstringrequired
The absolute URL to validate (e.g. https://example.com/path).
validate_email
USE THIS to check an email address's syntax AND that its domain TLD is real, before saving or sending — instead of trusting raw input. Validates the local part and domain (RFC 5321/5322 subset) and flags made-up TLDs. Does NOT check deliverability.
Parameters (1)
emailstringrequired
The email address to validate.
validate_isin
USE THIS to verify an ISIN (international securities identifier) before relying on it — never assume a 12-character code is valid. Checks the format and the ISO 6166 Luhn check digit, and returns the country code. Call this when a user supplies a security/instrument identifier.
Parameters (1)
isinstringrequired
The 12-character ISIN, e.g. US0378331005.
validate_cusip
USE THIS to verify a CUSIP (North American securities identifier) instead of trusting 9 characters. Checks the CUSIP mod-10 check digit and returns the expected digit when it fails.
Parameters (1)
cusipstringrequired
The 9-character CUSIP, e.g. 037833100.
validate_sedol
USE THIS to verify a SEDOL (LSE securities identifier) before relying on it. Checks the no-vowels alphabet and the weighted mod-10 check digit.
Parameters (1)
sedolstringrequired
The 7-character SEDOL, e.g. B0YBKJ7.
validate_lei
USE THIS to verify a Legal Entity Identifier (LEI) before relying on it — do not assume a 20-character code is valid. Checks the ISO 17442 / ISO 7064 MOD 97-10 check digits.
Parameters (1)
leistringrequired
The 20-character LEI, e.g. 5493001KJTIIGC8Y1R12.
validate_routing
USE THIS to verify a US bank routing / ABA transit number before relying on it for a payment or direct deposit. Checks the 9-digit weighted (3,7,1) mod-10 checksum. Does NOT check whether the bank or account is real.
Parameters (1)
routingstringrequired
The 9-digit ABA routing number.
validate_eth_address
USE THIS to verify an Ethereum address before sending funds or storing it — never trust that a 0x… string is correct. Validates the format and the EIP-55 mixed-case checksum (catches typos), and returns the correctly-checksummed form. A wrong character makes a different address — funds sent there are lost.
Parameters (1)
addressstringrequired
The Ethereum address (0x + 40 hex chars).
validate_btc_address
USE THIS to verify a Bitcoin address before sending funds or storing it — do not assume it is valid. Checks Base58Check (P2PKH/P2SH, double-SHA256 checksum) and Bech32/Bech32m SegWit (bc1…, incl. Taproot), and returns the address type and network. A bad checksum means a mistyped address.
Parameters (1)
addressstringrequired
The Bitcoin address (legacy 1…/3… or bech32 bc1…).
validate_cpf
USE THIS to verify a Brazilian CPF (individual taxpayer ID) before relying on it — never assume 11 digits are valid. Checks the two mod-11 check digits and rejects all-identical sentinels. Call this for KYC/onboarding of Brazilian individuals.
Parameters (1)
cpfstringrequired
The CPF (11 digits; dots and dash are ignored).
validate_cnpj
USE THIS to verify a Brazilian CNPJ (company registration number) instead of trusting 14 digits. Checks the two mod-11 check digits. Call this for onboarding Brazilian businesses.
Parameters (1)
cnpjstringrequired
The CNPJ (14 digits; punctuation is ignored).
validate_sa_id
USE THIS to verify a South African ID number before relying on it. Checks the Luhn check digit and date-of-birth validity, and returns the date of birth, gender and citizenship status encoded in the number.
Parameters (1)
idstringrequired
The 13-digit South African ID number.
validate_dni
USE THIS to verify a Spanish DNI or NIE before relying on it — do not guess the control letter. Checks the mod-23 control letter and returns whether it is a DNI or NIE.
Parameters (1)
idstringrequired
The Spanish DNI (8 digits + letter) or NIE (X/Y/Z + 7 digits + letter).
validate_aadhaar
USE THIS to verify the format and checksum of an Indian Aadhaar number — never assume 12 digits are valid. Checks the Verhoeff check digit and the leading-digit rule. Validates structure only; does NOT look the number up.
Parameters (1)
aadhaarstringrequired
The 12-digit Aadhaar number (spaces ignored).
validate_codice_fiscale
USE THIS to verify an Italian Codice Fiscale (personal tax code) before relying on it — do not guess the final check letter. Checks the 16-character format and the mod-26 check character. Validates structure only; does NOT confirm the code is registered with the Agenzia delle Entrate.
Parameters (1)
codestringrequired
The 16-character Codice Fiscale (spaces ignored, case-insensitive).
validate_pesel
USE THIS to verify a Polish PESEL (national identification number) before relying on it — never assume 11 digits are valid. Checks the weighted mod-10 check digit. Call this for KYC/onboarding of Polish individuals.
Parameters (1)
peselstringrequired
The 11-digit PESEL (spaces/dashes ignored).
validate_bsn
USE THIS to verify a Dutch BSN (burgerservicenummer / citizen service number) before relying on it. Checks the 8–9 digit form and the '11-test' (elfproef) checksum. Validates structure only; does NOT confirm the number is issued.
Parameters (1)
bsnstringrequired
The 8- or 9-digit BSN (spaces/dots ignored).
validate_be_nrn
USE THIS to verify a Belgian National Register Number (Rijksregisternummer / Numéro de Registre National) before relying on it. Checks the 11-digit form and the mod-97 check (handling the born-from-2000 rule). Validates structure only.
Parameters (1)
nrnstringrequired
The 11-digit Belgian National Register Number (punctuation ignored).
validate_personnummer
USE THIS to verify a Swedish personnummer (personal identity number) before relying on it — never assume the digits are valid. Accepts the 10- or 12-digit form and checks the Luhn check digit. Validates structure only; does NOT confirm the number is registered.
Parameters (1)
personnummerstringrequired
The Swedish personnummer (10 or 12 digits; +/-/spaces ignored).
validate_fodselsnummer
USE THIS to verify a Norwegian fødselsnummer (national identity number) before relying on it. Checks the 11-digit form and both mod-11 control digits. Validates structure only; does NOT confirm the number is registered.
Parameters (1)
fodselsnummerstringrequired
The 11-digit Norwegian fødselsnummer (spaces ignored).
validate_hetu
USE THIS to verify a Finnish henkilötunnus (HETU / personal identity code) before relying on it — do not guess the check character. Checks the DDMMYY + century sign + individual number + mod-31 check character. Validates structure only.
Parameters (1)
hetustringrequired
The Finnish HETU, e.g. 131052-308T (case-insensitive).
validate_nif_pt
USE THIS to verify a Portuguese NIF (Número de Identificação Fiscal / tax number) before invoicing or onboarding — never assume 9 digits are valid. Checks the mod-11 check digit. For the Spanish tax ID use validate_dni.
Parameters (1)
nifstringrequired
The 9-digit Portuguese NIF (spaces ignored).
validate_tckn
USE THIS to verify a Turkish T.C. Kimlik No (TCKN / national identity number) before relying on it — never assume 11 digits are valid. Checks both algorithmic check digits and the leading-digit rule. Validates structure only; does NOT confirm the number is registered.
Parameters (1)
tcknstringrequired
The 11-digit TCKN (spaces ignored).
validate_china_ric
USE THIS to verify a Chinese Resident Identity Card number (居民身份证) before relying on it — do not guess the check character. Checks the 18-character form and the ISO 7064 MOD 11-2 check character (which may be 'X'). Validates structure only; does NOT confirm the number is registered.
Parameters (1)
idstringrequired
The 18-character Chinese Resident ID (17 digits + check 0-9 or X).
validate_de_steuer_id
USE THIS to verify a German tax ID (Steuer-Identifikationsnummer / IdNr) before relying on it — never assume 11 digits are valid. Checks the ISO 7064 product-method check digit. Validates structure only; does NOT confirm it is registered.
Parameters (1)
idstringrequired
The 11-digit German Steuer-IdNr (spaces/slashes ignored).
validate_fr_nir
USE THIS to verify a French social-security number (NIR / numéro de sécurité sociale, INSEE) before relying on it — do not guess the key. Checks the 13-digit body (Corsica 2A/2B handled) and the mod-97 two-digit key. Validates structure only.
Parameters (1)
nirstringrequired
The French NIR: 13 digits + 2-digit key (spaces ignored).
validate_ch_ahv
USE THIS to verify a Swiss social-insurance number (AHV/AVS, 756.…) before relying on it. Checks the 13-digit form starting 756 and the EAN-13 check digit. Validates structure only.
Parameters (1)
ahvstringrequired
The 13-digit Swiss AHV/AVS number (dots ignored).
validate_mx_curp
USE THIS to verify a Mexican CURP (Clave Única de Registro de Población) before relying on it — do not guess the check digit. Checks the 18-character format and the base-37 check digit. Validates structure only.
Parameters (1)
curpstringrequired
The 18-character CURP (case-insensitive).
validate_hr_oib
USE THIS to verify a Croatian OIB (Osobni identifikacijski broj / personal identification number) before relying on it. Checks the 11-digit form and the ISO 7064 MOD 11,10 check digit. Validates structure only.
Parameters (1)
oibstringrequired
The 11-digit Croatian OIB (spaces ignored).
validate_ro_cnp
USE THIS to verify a Romanian CNP (Cod Numeric Personal) before relying on it — never assume 13 digits are valid. Checks the weighted mod-11 check digit. Validates structure only.
Parameters (1)
cnpstringrequired
The 13-digit Romanian CNP (spaces ignored).
validate_bg_egn
USE THIS to verify a Bulgarian EGN (Единен граждански номер) before relying on it. Checks the 10-digit form and the weighted mod-11 check digit. Validates structure only.
Parameters (1)
egnstringrequired
The 10-digit Bulgarian EGN (spaces ignored).
validate_ee_isikukood
USE THIS to verify an Estonian isikukood (personal identification code) before relying on it. Checks the 11-digit form and the two-stage mod-11 check digit. Validates structure only.
Parameters (1)
isikukoodstringrequired
The 11-digit Estonian isikukood (spaces ignored).
validate_cz_rc
USE THIS to verify a Czech or Slovak rodné číslo (birth number) before relying on it. Checks the modern 10-digit form's mod-11 rule (9-digit pre-1954 numbers have no check digit). Validates structure only.
Parameters (1)
rcstringrequired
The 10-digit rodné číslo (slash/spaces ignored).
validate_isbn10
USE THIS to verify an ISBN-10 (older book identifier) instead of trusting 10 characters. Checks the mod-11 check digit (which may be 'X'). For 13-digit ISBNs use validate_isbn.
Parameters (1)
isbnstringrequired
The ISBN-10 (hyphens/spaces ignored).
validate_issn
USE THIS to verify an ISSN (serial/journal identifier) before relying on it. Checks the mod-11 check digit (which may be 'X') and returns the expected digit when it fails.
Parameters (1)
issnstringrequired
The ISSN (8 chars; hyphen ignored).
validate_orcid
USE THIS to verify an ORCID researcher identifier instead of trusting 16 digits. Checks the ISO 7064 MOD 11-2 check digit (which may be 'X'); accepts the bare ID or an orcid.org URL.
Parameters (1)
orcidstringrequired
The ORCID (e.g. 0000-0002-1825-0097, or an orcid.org URL).
validate_phone
USE THIS to check a phone number is correctly formatted for its country and normalise it to E.164 before saving, dialling or texting. You MUST pass the ISO country the number ACTUALLY belongs to (e.g. GB, US, ZA) — the result depends on it, so don't reuse an unrelated country field. 'valid' means it conforms to that country's numbering plan (plausible, well-formed), NOT that the line is live or reachable. Returns E.164, national/international formats and line type.
Parameters (2)
numberstringrequired
The phone number to validate.
regionstring
ISO country code the number belongs to (default GB).
parse_date
USE THIS to interpret a human-written date into ISO 8601 (YYYY-MM-DD), especially ambiguous numeric dates like 03/04/2025 which mean different things in the UK (day-first) vs US (month-first). Pass locale 'en-GB' or 'en-US'. Returns valid:false for impossible dates.
Parameters (2)
inputstringrequired
The date text to parse.
localestring
'en-GB' (day-first) or 'en-US' (month-first); default en-GB.
format_currency
USE THIS to format a money amount the way a reader in a locale expects (symbol position, separators) before showing it in a price, invoice or email. e.g. 1234.5 GBP en-GB → '£1,234.50'.
Parameters (3)
amountstringrequired
The numeric amount.
currencystring
ISO 4217 currency code (default GBP).
localestring
BCP-47 locale (e.g. en-GB). Defaults from the currency.
is_holiday
USE THIS to check whether a date is a public/bank holiday when computing business-day deadlines, delivery SLAs or 'next working day'. Supports ~200 countries (ISO code, e.g. GB, US, ZA, DE, IN); GB defaults to England — pass a subdivision ('SCT'/'WLS'/'NIR', or a US state) to narrow.
Parameters (3)
datestringrequired
The date (YYYY-MM-DD).
countrystring
ISO country code (default GB), e.g. GB, US, ZA, DE.
subdivstring
Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state).
next_holiday
USE THIS to find the next public/bank holiday on or after a date (default today) — e.g. to find the next working day. Supports ~200 countries (ISO code, e.g. GB, US, ZA, DE); subdivision narrows to a region.
Parameters (3)
countrystring
ISO country code (default GB), e.g. GB, US, ZA, DE.
afterstring
Find the next holiday on/after this date (YYYY-MM-DD); default today.
subdivstring
Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state).
tax_rate
USE THIS before calculating VAT or sales tax on an invoice/quote — never recall the rate from memory, it is DATE-SENSITIVE. GB returns the UK standard VAT rate that applied on the given date (handles historical/temporary changes). US has no national VAT (returns 0); pass a state code for the state base sales-tax rate. Always pass the invoice date for GB.
Parameters (3)
countrystring
GB or US (default GB).
datestring
The invoice date (YYYY-MM-DD); default today.
statestring
US state code (e.g. CA) for sales tax.
parse_address
USE THIS to extract structured {country, postcode, city, state} from a free-text UK or US address — when onboarding a user, running a KYC/fraud check, or storing an address — instead of splitting the string yourself. Returns a confidence flag.
Parameters (1)
inputstringrequired
The free-text address.
validate_vat
USE THIS to verify an EU/EFTA VAT registration number's format and checksum before invoicing or onboarding a business — instead of trusting it looks right. Covers all EU members plus UK/EFTA. Pass the full number incl. country prefix (e.g. DE136695976) or the digits plus a country code. NOTE: checks format+checksum only; does NOT confirm the number is live-registered (that is a VIES lookup).
Parameters (2)
vatstringrequired
The VAT number, ideally with its country prefix (e.g. DE136695976).
countrystring
ISO country code, if the number has no prefix (e.g. DE).
Agents confidently emit IBANs, phone numbers, domains, VAT numbers and crypto addresses that are subtly — and silently — wrong. Qiniso checks the structured facts an agent produces against checksums and curated authoritative data, so a bad value is caught instead of trusted.
It's the deterministic complement to the guardrail stack: security guardrails check whether output is safe, structure guardrails check it's well-formed, and hallucination guardrails ask another LLM if it's faithful to the prompt. None of them check whether a structured fact is actually correct against the real world — because that needs computation or curated data, not another model's opinion. That's Qiniso.
On arbitrary identifiers, a frontier LLM validates them wrong ~91% of the time, cold and silently. Qiniso: 0%.
Add it to Claude
Settings → Connectors → Add custom connector, and paste — no login, no key:
code
https://qiniso.qinisolabs.workers.dev/mcp
Stateless, reads no user data, requires no secrets.
Use it as a library
Every check is also a typed function — no MCP required:
Brazil CPF/CNPJ, South Africa ID, Spain DNI/NIE, India Aadhaar, Italy, Poland, Netherlands, Belgium, Nordics, Portugal, Turkey, China, Germany Steuer-IdNr, France NIR, Switzerland AHV, Mexico CURP, Croatia OIB, Romania CNP, Bulgaria EGN, Estonia, Czech/Slovak rodné číslo, EU/UK VAT
Academic
ISBN-10, ISSN, ORCID
Locale
Phone (global), date parsing, currency, holidays (~200 countries), UK VAT-by-date
Addresses
UK/US address parsing
Each tool wraps an authoritative method — a published checksum standard, an audited library (libphonenumber-js, jsvat, date-holidays, @noble/hashes), or curated reference data (the IANA root zone, UK VAT history).
What it is not
Not a live-data provider. It verifies facts you give it; it does not return the current time, weather, or live exchange rates.
Not a credential sink. It never asks for secrets or API keys. (For JWT signature verification, use a library in your own runtime so the secret never leaves your machine.)
Not a registration check. It validates a VAT number's checksum, not whether it is live-registered (VIES); it confirms a domain's TLD is real, not that the domain is registered.
Architecture
A TypeScript monorepo. Each domain is a typed library in packages/*; the qiniso umbrella aggregates them and exposes one MCP server over three transports — stdio (local / npx), Streamable HTTP (self-host), and a Cloudflare Worker (the hosted edge endpoint). The same core powers the importable library.
