{
  "markdown": "<div align=\"center\">\n\n<img src=\"https://qinisolabs.github.io/sanctionwise/logo.svg\" width=\"96\" height=\"96\" alt=\"Qiniso\" />\n\n# sanctionwise\n\n**Verified UK sanctions screening for AI agents — official FCDO UK Sanctions List, not guesses.**\n\n*Verified, trustworthy data tools for AI agents. \"Qiniso\" means \"truth\" in Zulu.*\n\n[Website](https://qinisolabs.github.io/sanctionwise/) · [npm](https://www.npmjs.com/package/sanctionwise) · [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=sanctionwise)\n\n</div>\n\n---\n\nAsk an LLM \"is this person on the UK sanctions list?\" and it will answer from stale, fuzzy memory. Designations change constantly and are specific — that's data, not something to recall. **sanctionwise** screens a name against the **official FCDO UK Sanctions List** and returns possible matches with their real designation details, or a clean \"no match\".\n\n## ⚠️ Read this — what this is and is NOT\n\n- **Indicative name-match only.** A match is a **POSSIBLE** match that a human **must verify** against the official entry (names are widely shared and transliterated). It is **not** confirmation that the party you mean is the sanctioned party.\n- **A \"no match\" is NOT a clearance.** It covers the **UK (FCDO) list only**, screens the **name string you pass** (not DOBs or aliases you didn't supply), and reflects the **dataset's report date**, not real-time.\n- **Not advice.** Not legal, compliance, KYC/AML or sanctions advice, and **not a substitute for a regulated sanctions-screening process**. Every response includes this disclaimer.\n\n## Install\n\n```json\n{ \"mcpServers\": { \"sanctionwise\": { \"command\": \"npx\", \"args\": [\"-y\", \"sanctionwise\"] } } }\n```\n\nThe official UK Sanctions List data is **bundled** in the package (works offline, out of the box). The tool also **auto-refreshes** from a weekly-updated GitHub Release on startup — cached locally, no key, no token, no manual step — so it stays current on its own. Every response reports the dataset's report date.\n\n## Use it as a library\n\n```bash\nnpm i sanctionwise\n```\n\n```ts\nimport { screenName, getSanctionsEntry } from \"sanctionwise\";\n\nscreenName(\"Vladimir Putin\");\n// { matchCount: 3, results: [{ id: \"RUS0251\", type: \"Individual\",\n//   primaryName: \"Vladimir Vladimirovich PUTIN\", matchType: \"exact\",\n//   regimes: [\"The Russia (Sanctions) (EU Exit) Regulations 2019\"], sanctions: \"Asset freeze|…\" }],\n//   disclaimer: \"INDICATIVE NAME-MATCH SCREEN ONLY. …\" }\n\nscreenName(\"Acme Quilting Supplies Ltd\").matchCount;   // 0 — no match (NOT a clearance)\ngetSanctionsEntry(\"RUS0251\");                          // full official entry for a Unique ID\n```\n\nMatching folds accents and is case/punctuation-insensitive, and screens primary names **and aliases**.\n\n## Tools — 2\n\n| Tool | What it does |\n| --- | --- |\n| **screen_name** | Screen a person/company/vessel name → ranked POSSIBLE matches with official designation details |\n| **get_sanctions_entry** | Full official entry for a Unique ID (names, aliases, regime, statement of reasons, …) |\n\n## Data & auto-refresh\n\nThe data is the official **FCDO UK Sanctions List** (designated persons, entities and ships under the Sanctions and Anti-Money Laundering Act 2018), published under the **Open Government Licence v3.0**. `scripts/build-data.mjs` parses the official CSV into one record per target (all names/aliases grouped); the bundled build currently carries **6,200+ designated targets**. A weekly GitHub Action (`.github/workflows/refresh-data.yml`) re-downloads the list and publishes it as a **GitHub Release** asset; the installed tool fetches that asset on startup (cached, offline-safe), so it self-updates with **no npm token and no manual step**. The bundled copy is the offline / first-run fallback.\n\n## What it is *not*\n\n- **Not a compliance determination.** Indicative screening to surface possible matches for human review — nothing more.\n- **Not multi-list.** UK (FCDO) list only — not the EU, US (OFAC), UN consolidated, or any other list.\n- **Not real-time.** Reflects the dataset's report date; check the [live list](https://www.gov.uk/government/publications/the-uk-sanctions-list) for the current position.\n- **Not advice**, and not a regulated screening service.\n\n## Privacy\n\nThis tool runs locally on your machine and is built not to collect, store, or transmit your data — no analytics, no telemetry, no account. Screening runs locally; on startup it may **download** the latest public UK Sanctions List from a GitHub Release, but the names you screen are never transmitted. Full policy: <https://qinisolabs.github.io/privacy.html>.\n\n## License\n\nApache-2.0 (code). Sanctions data © Crown copyright, FCDO, Open Government Licence v3.0; see `NOTICE`.\n",
  "bytes": 4716,
  "sha": "32daab201a21d381c4804e21d47064e6afae31cd30e1fbb023c22f168da219b1",
  "repo_slug": "qinisolabs/sanctionwise",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qinisolabs_sanctionwise_8edcdd55/readme"
}