medical-terminologies-mcp 2.1.2 → 2.2.0

package/dist/index.js

@@ -30,7 +30,7 @@ function unknownCursorError(message) {
 var package_default = {
   name: "medical-terminologies-mcp",
   mcpName: "io.github.SidneyBissoli/medical-terminologies-mcp",
-  version: "2.1.2",
+  version: "2.2.0",
   description: "Unified MCP server for six medical terminologies (ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10) with authoritative WHO ICD-10\u2192ICD-11 mapping. 33 tools, hosted endpoint available, MIT.",
   author: "Sidney da Silva Pereira Bissoli",
   license: "MIT",
@@ -88,9 +88,9 @@ var package_default = {
   },
   dependencies: {
     "@modelcontextprotocol/server": "^2.0.0",
-    "@sbissoli/mcp-provenance": "^0.3.0",
+    "@sbissoli/mcp-provenance": "^0.4.0",
     "@sbissoli/mcp-search": "^0.9.0",
-    "@sbissoli/mcp-upstream": "^0.4.0",
+    "@sbissoli/mcp-upstream": "^0.4.2",
     pino: "^10.2.1",
     zod: "^4.5.4"
   },
@@ -2020,7 +2020,12 @@ var provenanceContext = createProvenanceContext({
   metaNamespace: "com.sidneybissoli.medical",
   locale: "en",
   timezone: "utc",
-  defaultMode: "concise"
+  defaultMode: "concise",
+  // Contract 1.2 (`field_sources` when a response joins sub-sources). This
+  // server never passes `field_sources` — multi-source responses carry one
+  // block per source — so the concise block, `_meta` and footer stay
+  // byte-identical to 1.1; only the canonical `contract_version` moves.
+  contractVersion: "1.2"
 });
 var PROVENANCE_META_KEY = provenanceContext.metaKeys.provenance;
 var ATTRIBUTION_META_KEY = provenanceContext.metaKeys.attribution;
@@ -2048,7 +2053,8 @@ var MEDICAL_SOURCES = {
       "ICD-11 content is served verbatim with code, title, and URI preserved (license \xA71.2.2\u20131.2.3)."
     ],
     cachePrefixes: ["icd11"],
-    defaultVintage: () => getEnv("WHO_ICD11_RELEASE_ID") ?? WHO_ICD11_DEFAULT_RELEASE
+    defaultVintage: () => getEnv("WHO_ICD11_RELEASE_ID") ?? WHO_ICD11_DEFAULT_RELEASE,
+    revision: { status: "current", note: "WHO publishes a new ICD-11 release annually (usually Jan-Feb); this server queries one pinned release." }
   },
   WHO_TRANSITION_TABLES: {
     name: "WHO ICD-10 \u2192 ICD-11 transition tables (bundled)",
@@ -2068,8 +2074,9 @@ var MEDICAL_SOURCES = {
       'WHO: "Mapping tables show the correspondence between ICD-10 and ICD-11 codes. They are not intended for directly converting data from one revision to the other."'
     ],
     cachePrefixes: [],
-    defaultVintage: () => null
+    defaultVintage: () => null,
     // caller passes the live dataset version
+    revision: { status: "current", note: "Bundled from one WHO release of the transition tables; ICD-10 itself is frozen (superseded by ICD-11)." }
   },
   DATASUS_CID10: {
     name: "CID-10 V2008 (DataSUS, bundled)",
@@ -2087,7 +2094,8 @@ var MEDICAL_SOURCES = {
     citation: (date) => `CID-10 V2008 \u2014 Classifica\xE7\xE3o Estat\xEDstica Internacional de Doen\xE7as, 10\xAA Revis\xE3o. DataSUS / Minist\xE9rio da Sa\xFAde do Brasil; Brazilian Portuguese translation by CBCD/USP; \xA9 World Health Organization. http://www2.datasus.gov.br/cid10/V2008/. Queried in-process on ${date}.`,
     notices: [],
     cachePrefixes: [],
-    defaultVintage: () => "V2008"
+    defaultVintage: () => "V2008",
+    revision: { status: "current", note: "Frozen since 2008: DataSUS has not published a successor to V2008." }
   },
   NLM_RXNAV: {
     name: "RxNorm (NLM RxNav API)",
@@ -2105,7 +2113,8 @@ var MEDICAL_SOURCES = {
     citation: (date) => `RxNorm, U.S. National Library of Medicine. Retrieved via the NLM RxNav API on ${date}.`,
     notices: [NLM_STATEMENT],
     cachePrefixes: ["rxnorm"],
-    defaultVintage: () => null
+    defaultVintage: () => null,
+    revision: { status: "current", note: "RxNorm is released monthly (first Monday); concepts update with each release." }
   },
   NLM_RXCLASS_ATC: {
     name: "ATC via NLM RxClass",
@@ -2125,7 +2134,8 @@ var MEDICAL_SOURCES = {
     // ATC shares the RxNorm client/host, so its accesses land on the same
     // cache prefix; the aggregation is per-host, which is honest here.
     cachePrefixes: ["rxnorm"],
-    defaultVintage: () => null
+    defaultVintage: () => null,
+    revision: { status: "current", note: "The WHO ATC classification is updated annually." }
   },
   NLM_MESH: {
     name: "MeSH (NLM Linked Data API)",
@@ -2143,7 +2153,8 @@ var MEDICAL_SOURCES = {
     citation: (date) => `MeSH (Medical Subject Headings). Courtesy of the U.S. National Library of Medicine. Retrieved via the MeSH Linked Data API on ${date}.`,
     notices: [NLM_STATEMENT],
     cachePrefixes: ["mesh"],
-    defaultVintage: () => null
+    defaultVintage: () => null,
+    revision: { status: "current", note: "MeSH is released annually (November)." }
   },
   CLINICALTABLES_LOINC: {
     name: "LOINC via NLM Clinical Tables",
@@ -2161,7 +2172,8 @@ var MEDICAL_SOURCES = {
     citation: (date) => `LOINC content retrieved via the NLM Clinical Tables API on ${date}. ${LOINC_NOTICE}`,
     notices: [LOINC_NOTICE, NLM_STATEMENT],
     cachePrefixes: ["loinc"],
-    defaultVintage: () => null
+    defaultVintage: () => null,
+    revision: { status: "current", note: "LOINC is released bi-annually; the release served varies by NLM update cycle." }
   },
   SERVER_METADATA: {
     name: "medical-terminologies-mcp (server-maintained metadata)",
@@ -2179,7 +2191,8 @@ var MEDICAL_SOURCES = {
     citation: (date) => `medical-terminologies-mcp \u2014 server-maintained metadata (not terminology content). https://github.com/SidneyBissoli/medical-terminologies-mcp. Generated on ${date}.`,
     notices: [],
     cachePrefixes: [],
-    defaultVintage: () => null
+    defaultVintage: () => null,
+    revision: { status: "current", note: null }
   }
 };
 function medicalProvenance(key, opts = {}) {
@@ -2209,6 +2222,7 @@ function medicalProvenance(key, opts = {}) {
     citation: src.citation(date, opts.citationDetail),
     license: src.license,
     notices: src.notices,
+    revision: src.revision,
     derived: opts.derived !== void 0,
     ...opts.derived !== void 0 ? { derivation_note: opts.derived.note } : {},
     served_from_cache: src.cachePrefixes.length === 0 ? null : meta.servedFromCache
@@ -2238,10 +2252,14 @@ var BLOCK_DESCRIPTIONS = {
   source_url: "Canonical URL of the source (API base or dataset release)",
   data_vintage: "Version/release of the data as exposed by the source; null when not exposed",
   retrieved_at: "Real instant of the upstream extraction (ISO-8601, UTC). Responses served from cache keep the ORIGINAL fetch instant.",
-  retrieval: "Origin diagnostics of THIS source in this call (contract v1.1): requests made to the upstream, attempts summed across retries, anomalies worked around (kind + count); unstable=true when any anomaly happened. null when nothing was measured (bundled dataset, or response served entirely from cache)",
+  retrieval: "Origin diagnostics of THIS source in this call: requests made to the upstream, attempts summed across retries, anomalies worked around (kind + count); unstable=true when any anomaly happened. null when nothing was measured (bundled dataset, or response served entirely from cache)",
   citation: "Ready-to-use citation/attribution string",
   license: "License / legal regime of the data",
-  field_sources: "Present only when the response joins parts from different origins or extraction instants (contract v1.2): for each group of fields, its URL, extraction instant and whether it came from cache. Absent in single-origin responses"
+  field_sources: "Present only when the response joins parts from different origins or extraction instants: for each group of fields, its URL, extraction instant and whether it came from cache. Absent in single-origin responses",
+  notices: "Notices the source publishes alongside the data (license statements, caveats), verbatim. Absent when there is none",
+  derived: "Present (true) only when this server computed the value (e.g. a ranking or summary statistics) instead of passing on what the source returned",
+  derivation_note: "What this server computed; present together with derived",
+  revision: "Whether the data can still change at the source: current = the version in force, the source may revise it; provisional = preliminary; final = will not change. Absent when unknown"
 };
 function describeFromJsonSchema(schema, node, overrides = {}, text = node?.description) {
   let out;
@@ -2282,7 +2300,7 @@ var provenanceBlockSchema = describeFromJsonSchema(
 function withProvenance(schema) {
   return schema.extend({
     provenance: provenanceBlockSchema.describe(
-      "Provenance block (contract v1.1): source, URL, data vintage, extraction instant, origin diagnostics, citation, license"
+      "Provenance block: source, URL, data vintage, extraction instant, origin diagnostics, citation, license"
     ),
     attribution: z3.array(z3.string()).describe("Canonical source URLs of this response (attribution list)")
   });
@@ -2290,7 +2308,7 @@ function withProvenance(schema) {
 function withProvenanceMulti(schema) {
   return schema.extend({
     provenance: z3.array(provenanceBlockSchema).describe(
-      "One provenance block per upstream source that contributed to this response (contract v1.1; licenses are never merged; each block carries the origin diagnostics of ITS source)"
+      "One provenance block per upstream source that contributed to this response (licenses are never merged; each block carries the origin diagnostics of ITS source)"
     ),
     attribution: z3.array(z3.string()).describe("Canonical source URLs of this response (attribution list)")
   });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "medical-terminologies-mcp",
   "mcpName": "io.github.SidneyBissoli/medical-terminologies-mcp",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Unified MCP server for six medical terminologies (ICD-11, LOINC, RxNorm, MeSH, ATC, CID-10) with authoritative WHO ICD-10→ICD-11 mapping. 33 tools, hosted endpoint available, MIT.",
   "author": "Sidney da Silva Pereira Bissoli",
   "license": "MIT",
@@ -59,9 +59,9 @@
   },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "@sbissoli/mcp-provenance": "^0.3.0",
+    "@sbissoli/mcp-provenance": "^0.4.0",
     "@sbissoli/mcp-search": "^0.9.0",
-    "@sbissoli/mcp-upstream": "^0.4.0",
+    "@sbissoli/mcp-upstream": "^0.4.2",
     "pino": "^10.2.1",
     "zod": "^4.5.4"
   },