@qinisolabs/qiniso 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +72 -0
- package/package.json +10 -1
package/README.md
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<img src="https://qinisolabs.github.io/qiniso/logo.svg" width="96" height="96" alt="Qiniso" />
|
|
4
|
+
|
|
5
|
+
# Qiniso
|
|
6
|
+
|
|
7
|
+
**The deterministic fact-verification layer for AI agents.**
|
|
8
|
+
|
|
9
|
+
*Verified, trustworthy data tools for AI agents. "Qiniso" means "truth" in Zulu.*
|
|
10
|
+
|
|
11
|
+
[Website](https://qinisolabs.github.io/qiniso/) · [GitHub](https://github.com/qinisolabs/qiniso) · [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=qiniso)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
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.
|
|
18
|
+
|
|
19
|
+
> On arbitrary identifiers, a frontier LLM validates them **wrong ~91% of the time, cold and silently. Qiniso: 0%.**
|
|
20
|
+
|
|
21
|
+
## Install
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm i @qinisolabs/qiniso
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Use as a library
|
|
28
|
+
|
|
29
|
+
Every check is a typed function — validate locally in one pass, no MCP required:
|
|
30
|
+
|
|
31
|
+
```ts
|
|
32
|
+
import { validateIban, validateVat, validatePhone } from "@qinisolabs/qiniso";
|
|
33
|
+
|
|
34
|
+
validateIban("GB82 WEST 1234 5698 7654 32");
|
|
35
|
+
// { valid: true, country: "United Kingdom", checkDigits: "82", ... }
|
|
36
|
+
|
|
37
|
+
validateVat("DE136695976"); // { valid: true, country: "Germany", ... }
|
|
38
|
+
validatePhone("020 7946 0123", "GB"); // { valid: true, e164: "+442079460123", ... }
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Use as an MCP server (in Claude and other agents)
|
|
42
|
+
|
|
43
|
+
No install needed — add the hosted endpoint as a custom connector:
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
https://qiniso.qinisolabs.workers.dev/mcp
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Or run it locally over stdio: `npx -p @qinisolabs/qiniso qiniso-mcp`.
|
|
50
|
+
|
|
51
|
+
## What it verifies — 33 tools across 8 domains
|
|
52
|
+
|
|
53
|
+
| Domain | Checks |
|
|
54
|
+
| --- | --- |
|
|
55
|
+
| **Identifiers** | IBAN, payment card (Luhn + brand), ISBN-13, VIN |
|
|
56
|
+
| **Web / network** | TLD & domain (IANA root zone), IP, UUID, URL, email |
|
|
57
|
+
| **Finance** | ISIN, CUSIP, SEDOL, LEI, US ABA routing |
|
|
58
|
+
| **Crypto** | Ethereum (EIP-55), Bitcoin (Base58Check / Bech32) addresses |
|
|
59
|
+
| **National & tax IDs** | Brazil CPF/CNPJ, South Africa ID, Spain DNI/NIE, India Aadhaar, EU/UK VAT |
|
|
60
|
+
| **Academic** | ISBN-10, ISSN, ORCID |
|
|
61
|
+
| **Locale** | Phone (global), date parsing, currency, holidays (~200 countries), UK VAT-by-date |
|
|
62
|
+
| **Addresses** | UK/US address parsing |
|
|
63
|
+
|
|
64
|
+
## What it is *not*
|
|
65
|
+
|
|
66
|
+
- **Not a live-data provider** — it verifies facts you give it; it does not return the current time, weather, or live FX.
|
|
67
|
+
- **Not a credential sink** — it never asks for secrets or keys.
|
|
68
|
+
- **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.
|
|
69
|
+
|
|
70
|
+
## License
|
|
71
|
+
|
|
72
|
+
Apache-2.0
|
package/package.json
CHANGED
|
@@ -1,8 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qinisolabs/qiniso",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"mcpName": "io.github.qinisolabs/qiniso",
|
|
5
5
|
"description": "The deterministic fact-verification layer for AI agents — verify identifiers, locale and more against authoritative ground truth.",
|
|
6
|
+
"homepage": "https://qinisolabs.github.io/qiniso/",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/qinisolabs/qiniso.git",
|
|
10
|
+
"directory": "packages/qiniso"
|
|
11
|
+
},
|
|
12
|
+
"bugs": {
|
|
13
|
+
"url": "https://github.com/qinisolabs/qiniso/issues"
|
|
14
|
+
},
|
|
6
15
|
"type": "module",
|
|
7
16
|
"main": "dist/index.js",
|
|
8
17
|
"types": "dist/index.d.ts",
|