@whiteintel/mcp-server - npm Package Compare versions

Comparing version 0.6.0 to 0.7.0

CHANGELOG.md

 # Changelog
 
+## 0.7.0 — 2026-07-22
+
+- **Semantic (meaning-based) retrieval.** Two new tools over the corpus-RAG dossier
+  cards: `semantic_search` (BGE-M3 vector ANN — find companies/people whose profile is
+  closest to a natural-language query, even with no keyword match; complements the lexical
+  `search_entities`) and `find_similar` ("more like this" around a known `entity_id`).
+  Both return `entity_id, caption, kind, jurisdiction, risk` + a similarity score. Coverage
+  grows as the embedding backfill runs — results may be sparse until then.
+
 ## 0.6.0 — 2026-07-21
@@ -4,0 +13,0 @@

index.js

@@ -448,2 +448,33 @@ #!/usr/bin/env node
   },
+  // ── Corpus-RAG: semantic (meaning-based) retrieval over the resolved dossier cards ──
+  {
+    name: "semantic_search",
+    description:
+      "Meaning-based entity search over the corpus (BGE-M3 vector ANN over the resolved dossier cards). Finds companies and people whose profile is semantically closest to a natural-language query — a description, a role, a risk pattern — even when no keyword matches. Complements search_entities (lexical/name). Optional kind (Company/Person/Asset) and jurisdiction (ISO code) filters. Returns entity_id, caption, kind, jurisdiction, risk and a similarity score; feed entity_id into get_dossier / trace_ownership_path. (Coverage grows as the embedding backfill runs; results may be sparse until then.)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", maxLength: 500, description: "Natural-language search, e.g. 'sanctioned Russian aluminium holding company'." },
+        k: { type: "number", minimum: 1, maximum: 50, description: "Max hits (default 10)." },
+        kind: { type: "string", description: "Optional entity-kind filter (Company / Person / Asset / …)." },
+        jurisdiction: { type: "string", description: "Optional ISO jurisdiction filter (e.g. GB, RU)." },
+      },
+      required: ["query"],
+    },
+    handler: (a) => apiGet(`/api/public/semantic-search${qs({ q: a.query, k: a.k ?? 10, kind: a.kind, juris: a.jurisdiction })}`),
+  },
+  {
+    name: "find_similar",
+    description:
+      "Entities most similar to a given one — the nearest corpus dossier cards ('more like this'), for peer discovery and clustering around a known entity. Pass an entity_id from search_entities. Returns entity_id, caption, kind, jurisdiction, risk and a similarity score. (Coverage grows as the embedding backfill runs.)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entity_id: { type: "string", maxLength: 80, description: "Entity uuid from search_entities." },
+        k: { type: "number", minimum: 1, maximum: 50, description: "Max hits (default 10)." },
+      },
+      required: ["entity_id"],
+    },
+    handler: (a) => apiGet(`/api/public/similar/${encodeURIComponent(String(a.entity_id).trim())}${qs({ k: a.k ?? 10 })}`),
+  },
 ];
@@ -454,3 +485,3 @@
 const server = new Server(
-  { name: "whiteintel-mcp-server", version: "0.6.0" },
+  { name: "whiteintel-mcp-server", version: "0.7.0" },
   { capabilities: { tools: {} } },
@@ -457,0 +488,0 @@ );

package.json

 {
   "name": "@whiteintel/mcp-server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Model Context Protocol server for WhiteIntel — corporate & offshore ownership intelligence. Look up companies, search entities (companies + people), screen sanctions, and trace ownership chains to the ultimate beneficial owner. Freemium: anonymous free tier, or set WHITEINTEL_API_KEY for your plan.",
@@ -5,0 +5,0 @@ "type": "module",

New alerts

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

42742

7.04%

Lines of code

558

6.49%

No dependency changes