About Qiniso
Qiniso is a local fact-validation library and MCP server for agents that need to check structured identifiers and values. It uses checksums and bundled reference data rather than live-data lookups.
Key features
- 01Checksum and curated-data validation
- 02Checks across eight data domains
- 0356 typed verification tools
- 04Local operation without network calls
Use cases
- 01Validate IBANs, VAT numbers, and phone numbers
- 02Check crypto addresses and financial identifiers
- 03Parse addresses, dates, and currencies
MCP support
Qiniso exposes verification tools to MCP clients through a hosted endpoint or a local stdio server. The same checks are also available as library functions without MCP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://qiniso.qinisolabs.workers.dev/mcpclaude mcp add --transport http qinisolabs-qiniso https://qiniso.qinisolabs.workers.dev/mcp{"mcpServers":{"qinisolabs-qiniso":{"type":"http","url":"https://qiniso.qinisolabs.workers.dev/mcp"}}}Open in Cursor{"servers":{"qinisolabs-qiniso":{"type":"http","url":"https://qiniso.qinisolabs.workers.dev/mcp"}}}Open in VS Code{"mcpServers":{"qinisolabs-qiniso":{"type":"http","url":"https://qiniso.qinisolabs.workers.dev/mcp"}}}{"mcpServers":{"qinisolabs-qiniso":{"serverUrl":"https://qiniso.qinisolabs.workers.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
56| Parameter | Type | Required | Description |
|---|---|---|---|
| iban | string | Yes | The IBAN to validate; spaces are ignored. |
Details
From the project READMEQiniso
The deterministic fact-verification layer for AI agents.
Verified, trustworthy data tools for AI agents. "Qiniso" means "truth" in Zulu.
Website · npm · GitHub · 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.
On arbitrary identifiers, a frontier LLM validates them wrong ~91% of the time, cold and silently. Qiniso: 0%.
Install
npm i @qinisolabs/qiniso
Use as a library
Every check is a typed function — validate locally in one pass, no MCP required:
import { validateIban, validateVat, validatePhone } from "@qinisolabs/qiniso";
validateIban("GB82 WEST 1234 5698 7654 32");
// { valid: true, country: "United Kingdom", checkDigits: "82", ... }
validateVat("DE136695976"); // { valid: true, country: "Germany", ... }
validatePhone("020 7946 0123", "GB"); // { valid: true, e164: "+442079460123", ... }
Use as an MCP server (in Claude and other agents)
No install needed — add the hosted endpoint as a custom connector:
https://qiniso.qinisolabs.workers.dev/mcp
Or run it locally over stdio. Add this to your client's MCP config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"qiniso": {
"command": "npx",
"args": ["-y", "-p", "@qinisolabs/qiniso", "qiniso-mcp"]
}
}
}
What it verifies — 56 tools across 8 domains
| Domain | Checks |
|---|---|
| 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 |
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 FX.
- Not a credential sink — it never asks for secrets or keys.
- Not a registration check — it validates a VAT number's checksum, not whether it is live-registered (VIES); it confirms a TLD is real, not that a domain is registered.
Privacy
This tool runs locally on your machine and is built not to collect, store, or transmit your data — no analytics, no telemetry, no account. All reference data is bundled — no network calls, and nothing leaves your device. Full policy: https://qinisolabs.github.io/privacy.html.
License
Apache-2.0
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.