Qiniso

Official56 toolsLive

by qinisolabs · TypeScript

Deterministic fact verification for AI agents — checksums & curated data, not guesses.

Qiniso MCP Server (io.github.qinisolabs/qiniso)

Qiniso provides a deterministic fact-verification layer for AI agents, using checksums and curated data rather than guesses. The server exposes an MCP endpoint for agent tooling, centered on verified data outputs such as IBANs, phone numbers, domains, VAT numbers, and crypto addresses.

🛠️ Key Features

Deterministic fact verification
Checksums for verification
Curated data (not guesses)
Tooling support for verified data types (IBANs, phone numbers, domains, VAT numbers, crypto addresses)
56 tools available

🚀 Use Cases

Validating outputs generated by AI agents (e.g., IBANs and VAT numbers)
Reducing uncertainty in agent-supplied identifiers (domains, phone numbers, crypto addresses)

⚡ Developer Benefits

Integrates with Model Context Protocol via the provided MCP endpoint
Uses a verification approach grounded in checksums and curated datasets
Relevant ecosystem tags: TypeScript, validation, verification, and MCP

⚠️ Limitations

Described as a deterministic verification layer; no additional behaviors beyond checksum/curated-data verification are specified.

Topics

ai-agentschecksumclaudefintechllmmcpmodel-context-protocoltypescriptvalidationverification

Captured live from the server via tools/list.

validate_iban

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.

Parameters1

iban

string

required

The IBAN to validate; spaces are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "iban": {
      "type": "string",
      "description": "The IBAN to validate; spaces are ignored."
    }
  },
  "required": [
    "iban"
  ],
  "additionalProperties": false
}

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.

Parameters1

number

string

required

The card number; spaces and dashes are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "The card number; spaces and dashes are ignored."
    }
  },
  "required": [
    "number"
  ],
  "additionalProperties": false
}

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.

Parameters1

isbn

string

required

The ISBN-13; hyphens and spaces are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "isbn": {
      "type": "string",
      "description": "The ISBN-13; hyphens and spaces are ignored."
    }
  },
  "required": [
    "isbn"
  ],
  "additionalProperties": false
}

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.

Parameters1

vin

string

required

The 17-character VIN to validate.

Raw schema

{
  "type": "object",
  "properties": {
    "vin": {
      "type": "string",
      "description": "The 17-character VIN to validate."
    }
  },
  "required": [
    "vin"
  ],
  "additionalProperties": false
}

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.

Parameters1

gtin

string

required

The barcode digits (EAN-8/UPC-A/EAN-13/GTIN-14); spaces and hyphens are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string",
      "description": "The barcode digits (EAN-8/UPC-A/EAN-13/GTIN-14); spaces and hyphens are ignored."
    }
  },
  "required": [
    "gtin"
  ],
  "additionalProperties": false
}

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.

Parameters1

imei

string

required

The 15-digit IMEI (or 16-digit IMEISV); spaces and dashes are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "imei": {
      "type": "string",
      "description": "The 15-digit IMEI (or 16-digit IMEISV); spaces and dashes are ignored."
    }
  },
  "required": [
    "imei"
  ],
  "additionalProperties": false
}

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.

Parameters1

gln

string

required

The 13-digit GLN; spaces and dashes are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "gln": {
      "type": "string",
      "description": "The 13-digit GLN; spaces and dashes are ignored."
    }
  },
  "required": [
    "gln"
  ],
  "additionalProperties": false
}

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.

Parameters1

sscc

string

required

The 18-digit SSCC; spaces and dashes are ignored.

Raw schema

{
  "type": "object",
  "properties": {
    "sscc": {
      "type": "string",
      "description": "The 18-digit SSCC; spaces and dashes are ignored."
    }
  },
  "required": [
    "sscc"
  ],
  "additionalProperties": false
}

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.

Parameters1

tld

string

required

The TLD to check, with or without a leading dot (e.g. 'zip' or '.zip').

Raw schema

{
  "type": "object",
  "properties": {
    "tld": {
      "type": "string",
      "description": "The TLD to check, with or without a leading dot (e.g. 'zip' or '.zip')."
    }
  },
  "required": [
    "tld"
  ],
  "additionalProperties": false
}

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.

Parameters1

domain

string

required

The domain name, e.g. 'example.com'.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain name, e.g. 'example.com'."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The IPv4 or IPv6 address to validate.

Raw schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IPv4 or IPv6 address to validate."
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false
}

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.

Parameters1

uuid

string

required

The UUID string to validate.

Raw schema

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The UUID string to validate."
    }
  },
  "required": [
    "uuid"
  ],
  "additionalProperties": false
}

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.

Parameters1

url

string

required

The absolute URL to validate (e.g. https://example.com/path).

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The absolute URL to validate (e.g. https://example.com/path)."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The email address to validate.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to validate."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

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.

Parameters1

isin

string

required

The 12-character ISIN, e.g. US0378331005.

Raw schema

{
  "type": "object",
  "properties": {
    "isin": {
      "type": "string",
      "description": "The 12-character ISIN, e.g. US0378331005."
    }
  },
  "required": [
    "isin"
  ],
  "additionalProperties": false
}

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.

Parameters1

cusip

string

required

The 9-character CUSIP, e.g. 037833100.

Raw schema

{
  "type": "object",
  "properties": {
    "cusip": {
      "type": "string",
      "description": "The 9-character CUSIP, e.g. 037833100."
    }
  },
  "required": [
    "cusip"
  ],
  "additionalProperties": false
}

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.

Parameters1

sedol

string

required

The 7-character SEDOL, e.g. B0YBKJ7.

Raw schema

{
  "type": "object",
  "properties": {
    "sedol": {
      "type": "string",
      "description": "The 7-character SEDOL, e.g. B0YBKJ7."
    }
  },
  "required": [
    "sedol"
  ],
  "additionalProperties": false
}

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.

Parameters1

lei

string

required

The 20-character LEI, e.g. 5493001KJTIIGC8Y1R12.

Raw schema

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string",
      "description": "The 20-character LEI, e.g. 5493001KJTIIGC8Y1R12."
    }
  },
  "required": [
    "lei"
  ],
  "additionalProperties": false
}

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.

Parameters1

routing

string

required

The 9-digit ABA routing number.

Raw schema

{
  "type": "object",
  "properties": {
    "routing": {
      "type": "string",
      "description": "The 9-digit ABA routing number."
    }
  },
  "required": [
    "routing"
  ],
  "additionalProperties": false
}

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.

Parameters1

address

string

required

The Ethereum address (0x + 40 hex chars).

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The Ethereum address (0x + 40 hex chars)."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

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.

Parameters1

address

string

required

The Bitcoin address (legacy 1…/3… or bech32 bc1…).

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "The Bitcoin address (legacy 1…/3… or bech32 bc1…)."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

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.

Parameters1

cpf

string

required

The CPF (11 digits; dots and dash are ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "cpf": {
      "type": "string",
      "description": "The CPF (11 digits; dots and dash are ignored)."
    }
  },
  "required": [
    "cpf"
  ],
  "additionalProperties": false
}

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.

Parameters1

cnpj

string

required

The CNPJ (14 digits; punctuation is ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "cnpj": {
      "type": "string",
      "description": "The CNPJ (14 digits; punctuation is ignored)."
    }
  },
  "required": [
    "cnpj"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The 13-digit South African ID number.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The 13-digit South African ID number."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The Spanish DNI (8 digits + letter) or NIE (X/Y/Z + 7 digits + letter).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The Spanish DNI (8 digits + letter) or NIE (X/Y/Z + 7 digits + letter)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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.

Parameters1

aadhaar

string

required

The 12-digit Aadhaar number (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "aadhaar": {
      "type": "string",
      "description": "The 12-digit Aadhaar number (spaces ignored)."
    }
  },
  "required": [
    "aadhaar"
  ],
  "additionalProperties": false
}

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.

Parameters1

code

string

required

The 16-character Codice Fiscale (spaces ignored, case-insensitive).

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The 16-character Codice Fiscale (spaces ignored, case-insensitive)."
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

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.

Parameters1

pesel

string

required

The 11-digit PESEL (spaces/dashes ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "pesel": {
      "type": "string",
      "description": "The 11-digit PESEL (spaces/dashes ignored)."
    }
  },
  "required": [
    "pesel"
  ],
  "additionalProperties": false
}

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.

Parameters1

bsn

string

required

The 8- or 9-digit BSN (spaces/dots ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "bsn": {
      "type": "string",
      "description": "The 8- or 9-digit BSN (spaces/dots ignored)."
    }
  },
  "required": [
    "bsn"
  ],
  "additionalProperties": false
}

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.

Parameters1

nrn

string

required

The 11-digit Belgian National Register Number (punctuation ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "nrn": {
      "type": "string",
      "description": "The 11-digit Belgian National Register Number (punctuation ignored)."
    }
  },
  "required": [
    "nrn"
  ],
  "additionalProperties": false
}

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.

Parameters1

personnummer

string

required

The Swedish personnummer (10 or 12 digits; +/-/spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "personnummer": {
      "type": "string",
      "description": "The Swedish personnummer (10 or 12 digits; +/-/spaces ignored)."
    }
  },
  "required": [
    "personnummer"
  ],
  "additionalProperties": false
}

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.

Parameters1

fodselsnummer

string

required

The 11-digit Norwegian fødselsnummer (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "fodselsnummer": {
      "type": "string",
      "description": "The 11-digit Norwegian fødselsnummer (spaces ignored)."
    }
  },
  "required": [
    "fodselsnummer"
  ],
  "additionalProperties": false
}

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.

Parameters1

hetu

string

required

The Finnish HETU, e.g. 131052-308T (case-insensitive).

Raw schema

{
  "type": "object",
  "properties": {
    "hetu": {
      "type": "string",
      "description": "The Finnish HETU, e.g. 131052-308T (case-insensitive)."
    }
  },
  "required": [
    "hetu"
  ],
  "additionalProperties": false
}

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.

Parameters1

nif

string

required

The 9-digit Portuguese NIF (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "nif": {
      "type": "string",
      "description": "The 9-digit Portuguese NIF (spaces ignored)."
    }
  },
  "required": [
    "nif"
  ],
  "additionalProperties": false
}

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.

Parameters1

tckn

string

required

The 11-digit TCKN (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "tckn": {
      "type": "string",
      "description": "The 11-digit TCKN (spaces ignored)."
    }
  },
  "required": [
    "tckn"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The 18-character Chinese Resident ID (17 digits + check 0-9 or X).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The 18-character Chinese Resident ID (17 digits + check 0-9 or X)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The 11-digit German Steuer-IdNr (spaces/slashes ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The 11-digit German Steuer-IdNr (spaces/slashes ignored)."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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.

Parameters1

nir

string

required

The French NIR: 13 digits + 2-digit key (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "nir": {
      "type": "string",
      "description": "The French NIR: 13 digits + 2-digit key (spaces ignored)."
    }
  },
  "required": [
    "nir"
  ],
  "additionalProperties": false
}

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.

Parameters1

ahv

string

required

The 13-digit Swiss AHV/AVS number (dots ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "ahv": {
      "type": "string",
      "description": "The 13-digit Swiss AHV/AVS number (dots ignored)."
    }
  },
  "required": [
    "ahv"
  ],
  "additionalProperties": false
}

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.

Parameters1

curp

string

required

The 18-character CURP (case-insensitive).

Raw schema

{
  "type": "object",
  "properties": {
    "curp": {
      "type": "string",
      "description": "The 18-character CURP (case-insensitive)."
    }
  },
  "required": [
    "curp"
  ],
  "additionalProperties": false
}

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.

Parameters1

oib

string

required

The 11-digit Croatian OIB (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "oib": {
      "type": "string",
      "description": "The 11-digit Croatian OIB (spaces ignored)."
    }
  },
  "required": [
    "oib"
  ],
  "additionalProperties": false
}

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.

Parameters1

cnp

string

required

The 13-digit Romanian CNP (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "cnp": {
      "type": "string",
      "description": "The 13-digit Romanian CNP (spaces ignored)."
    }
  },
  "required": [
    "cnp"
  ],
  "additionalProperties": false
}

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.

Parameters1

egn

string

required

The 10-digit Bulgarian EGN (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "egn": {
      "type": "string",
      "description": "The 10-digit Bulgarian EGN (spaces ignored)."
    }
  },
  "required": [
    "egn"
  ],
  "additionalProperties": false
}

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.

Parameters1

isikukood

string

required

The 11-digit Estonian isikukood (spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "isikukood": {
      "type": "string",
      "description": "The 11-digit Estonian isikukood (spaces ignored)."
    }
  },
  "required": [
    "isikukood"
  ],
  "additionalProperties": false
}

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.

Parameters1

string

required

The 10-digit rodné číslo (slash/spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "rc": {
      "type": "string",
      "description": "The 10-digit rodné číslo (slash/spaces ignored)."
    }
  },
  "required": [
    "rc"
  ],
  "additionalProperties": false
}

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.

Parameters1

isbn

string

required

The ISBN-10 (hyphens/spaces ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "isbn": {
      "type": "string",
      "description": "The ISBN-10 (hyphens/spaces ignored)."
    }
  },
  "required": [
    "isbn"
  ],
  "additionalProperties": false
}

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.

Parameters1

issn

string

required

The ISSN (8 chars; hyphen ignored).

Raw schema

{
  "type": "object",
  "properties": {
    "issn": {
      "type": "string",
      "description": "The ISSN (8 chars; hyphen ignored)."
    }
  },
  "required": [
    "issn"
  ],
  "additionalProperties": false
}

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.

Parameters1

orcid

string

required

The ORCID (e.g. 0000-0002-1825-0097, or an orcid.org URL).

Raw schema

{
  "type": "object",
  "properties": {
    "orcid": {
      "type": "string",
      "description": "The ORCID (e.g. 0000-0002-1825-0097, or an orcid.org URL)."
    }
  },
  "required": [
    "orcid"
  ],
  "additionalProperties": false
}

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.

Parameters2

number	string	required	The phone number to validate.
region	string	optional	ISO country code the number belongs to (default GB).

Raw schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "The phone number to validate."
    },
    "region": {
      "type": "string",
      "description": "ISO country code the number belongs to (default GB)."
    }
  },
  "required": [
    "number"
  ],
  "additionalProperties": false
}

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.

Parameters2

input	string	required	The date text to parse.
locale	string	optional	'en-GB' (day-first) or 'en-US' (month-first); default en-GB.

Raw schema

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "description": "The date text to parse."
    },
    "locale": {
      "type": "string",
      "description": "'en-GB' (day-first) or 'en-US' (month-first); default en-GB."
    }
  },
  "required": [
    "input"
  ],
  "additionalProperties": false
}

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'.

Parameters3

amount	string	required	The numeric amount.
currency	string	optional	ISO 4217 currency code (default GBP).
locale	string	optional	BCP-47 locale (e.g. en-GB). Defaults from the currency.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string",
      "description": "The numeric amount."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code (default GBP)."
    },
    "locale": {
      "type": "string",
      "description": "BCP-47 locale (e.g. en-GB). Defaults from the currency."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false
}

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.

Parameters3

date	string	required	The date (YYYY-MM-DD).
country	string	optional	ISO country code (default GB), e.g. GB, US, ZA, DE.
subdiv	string	optional	Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "The date (YYYY-MM-DD)."
    },
    "country": {
      "type": "string",
      "description": "ISO country code (default GB), e.g. GB, US, ZA, DE."
    },
    "subdiv": {
      "type": "string",
      "description": "Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state)."
    }
  },
  "required": [
    "date"
  ],
  "additionalProperties": false
}

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.

Parameters3

country	string	optional	ISO country code (default GB), e.g. GB, US, ZA, DE.
after	string	optional	Find the next holiday on/after this date (YYYY-MM-DD); default today.
subdiv	string	optional	Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state).

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO country code (default GB), e.g. GB, US, ZA, DE."
    },
    "after": {
      "type": "string",
      "description": "Find the next holiday on/after this date (YYYY-MM-DD); default today."
    },
    "subdiv": {
      "type": "string",
      "description": "Subdivision code (e.g. UK nation SCT/WLS/NIR, or a US state)."
    }
  },
  "required": [],
  "additionalProperties": false
}

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.

Parameters3

country	string	optional	GB or US (default GB).
date	string	optional	The invoice date (YYYY-MM-DD); default today.
state	string	optional	US state code (e.g. CA) for sales tax.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "GB or US (default GB)."
    },
    "date": {
      "type": "string",
      "description": "The invoice date (YYYY-MM-DD); default today."
    },
    "state": {
      "type": "string",
      "description": "US state code (e.g. CA) for sales tax."
    }
  },
  "required": [],
  "additionalProperties": false
}

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.

Parameters1

input

string

required

The free-text address.

Raw schema

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "description": "The free-text address."
    }
  },
  "required": [
    "input"
  ],
  "additionalProperties": false
}

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).

Parameters2

vat	string	required	The VAT number, ideally with its country prefix (e.g. DE136695976).
country	string	optional	ISO country code, if the number has no prefix (e.g. DE).

Raw schema

{
  "type": "object",
  "properties": {
    "vat": {
      "type": "string",
      "description": "The VAT number, ideally with its country prefix (e.g. DE136695976)."
    },
    "country": {
      "type": "string",
      "description": "ISO country code, if the number has no prefix (e.g. DE)."
    }
  },
  "required": [
    "vat"
  ],
  "additionalProperties": false
}

README.md4 KBView on GitHub

Qiniso

The deterministic fact-verification layer for AI agents.

Verified, trustworthy data tools for AI agents. "Qiniso" means "truth" in Zulu.

Website · npm · MCP endpoint · MCP Registry

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:

bash

npm i @qinisolabs/qiniso

import { validateIban, validateVat } from "@qinisolabs/qiniso";

validateIban("GB82 WEST 1234 5698 7654 32");
// { valid: true, country: "United Kingdom", ... }

What it verifies — 56 tools across 8 domains

Domain	Tools
Identifiers	IBAN, payment card (Luhn + brand), ISBN-13, VIN, GTIN/UPC/EAN barcodes (+ GS1 country)
Web / network	TLD & domain (IANA root zone), IP, UUID, URL, email
Finance	ISIN, CUSIP, SEDOL, LEI, US ABA routing
Crypto	Ethereum (EIP-55), Bitcoin (Base58Check / Bech32) addresses
National & tax IDs	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.

bash

npm install
npm run build
npm test

License

Apache-2.0

Install

Tools (56)

validate_ibanvalidate_cardvalidate_isbnvalidate_vinvalidate_gtinvalidate_imeivalidate_glnvalidate_sscc

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "qiniso": {
      "command": "npx",
      "args": [
        "-y",
        "@qinisolabs/qiniso@0.5.0"
      ]
    }
  }
}

Qiniso MCP Server (io.github.qinisolabs/qiniso)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

validate_iban

validate_card

validate_isbn

validate_vin

validate_gtin

validate_imei

validate_gln

validate_sscc

validate_tld

validate_domain

validate_ip

validate_uuid

validate_url

validate_email

validate_isin

validate_cusip

validate_sedol

validate_lei

validate_routing

validate_eth_address

validate_btc_address

validate_cpf

validate_cnpj

validate_sa_id

validate_dni

validate_aadhaar

validate_codice_fiscale

validate_pesel

validate_bsn

validate_be_nrn

validate_personnummer

validate_fodselsnummer

validate_hetu

validate_nif_pt

validate_tckn

validate_china_ric

validate_de_steuer_id

validate_fr_nir

validate_ch_ahv

validate_mx_curp

validate_hr_oib

validate_ro_cnp

validate_bg_egn

validate_ee_isikukood

validate_cz_rc

validate_isbn10

validate_issn

validate_orcid

validate_phone

parse_date

format_currency

is_holiday

next_holiday

tax_rate

parse_address

validate_vat

Qiniso

Add it to Claude

Use it as a library

What it verifies — 56 tools across 8 domains

What it is not

Architecture

License

Install

Related servers