@pharmatools/pubcrawl 2.5.0 → 2.5.1

package/README.md

@@ -28,12 +28,24 @@ PubCrawl connects your AI assistant (Claude Desktop, Cursor, or any MCP-compatib
 
 Every tool is a thin, deterministic wrapper over an official API. Nothing is invented; every result cites its source.
 
+### The thing no other MCP server does
+
+Ask **"compare US and UK labelling for semaglutide"** and PubCrawl pulls both live labels and maps equivalent sections — US *Indications and Usage* ↔ UK *4.1 Therapeutic indications*, and so on — so the differences are visible instead of assumed:
+
+| | US Prescribing Information | UK SmPC |
+|---|---|---|
+| **Indications** | glycaemic control · **reduce risk of MACE** in T2D with established CVD · **reduce risk of sustained eGFR decline, ESKD and CV death** in T2D with CKD | glycaemic control only — CV and renal outcomes appear as cross-references to §4.4/4.5/5.1, *not* as indications |
+| **Contraindications** | personal or family history of MTC or MEN 2 · hypersensitivity | hypersensitivity only |
+
+A cardiovascular claim that is on-label in the US promotes an unlicensed indication in the UK. If you write, review, or check medical copy for both markets, that gap is the whole job — and `compare_labels` is the only MCP tool that surfaces it.
+
+### Everything else
+
 - 🔬 **14 tools** across literature, drug labelling, and clinical trials
 - 🧾 **Verifiable by design** — results link back to DailyMed, the eMC, PubMed, and ClinicalTrials.gov
-- 🌍 **US *and* UK labelling** — a side-by-side `compare_labels` no other MCP server offers
 - 📰 **Preprints** via Europe PMC — surface work ahead of formal publication
 - 🆓 **No API keys required** (an optional free NCBI key raises PubMed rate limits)
-- 🧪 Fully **typed, tested, and CI-checked**
+- 🧪 Fully **typed, tested, and CI-checked** — retrieval fidelity gated by [OpenGATE](https://github.com/nickjlamb/opengate) on every release
 
 Built by [PharmaTools.AI](https://pharmatools.ai).
 
@@ -133,32 +145,10 @@ Once connected, just ask naturally:
 
 Three layers — **tools** register the MCP interface, **lib clients** talk to each external API, and shared **cache** + **parsers** keep it fast and consistent.
 
-```mermaid
-flowchart LR
-    Client["🖥  MCP client<br/>Claude Desktop · Cursor · …"]
-
-    subgraph Server["PubCrawl MCP server"]
-        direction TB
-        Transport["stdio · Streamable HTTP"]
-        Tools["14 tools — src/tools/*"]
-        Shared["LRU cache · XML/JATS/SPL parser"]
-        Transport --> Tools --> Shared
-    end
-
-    Client -->|MCP| Transport
-
-    Tools --> NCBI["NCBI E-utilities"]
-    Tools --> EPMC["Europe PMC REST"]
-    Tools --> FDA["openFDA + DailyMed"]
-    Tools --> EMC["UK eMC"]
-    Tools --> CT["ClinicalTrials.gov v2"]
-
-    NCBI --> S1[("PubMed / PMC")]
-    EPMC --> S2[("Preprints · patents")]
-    FDA --> S3[("US labels")]
-    EMC --> S4[("UK labels")]
-    CT --> S5[("Trials")]
-```
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="docs/architecture-dark.svg">
+  <img src="docs/architecture-light.svg" alt="PubCrawl architecture: an MCP client connects over stdio or streamable HTTP to the PubCrawl server, whose 14 tools are grouped into literature, drug labelling and clinical trials. Each family calls the official APIs directly — NCBI E-utilities, Europe PMC, openFDA and DailyMed, the UK eMC, and ClinicalTrials.gov — behind a shared LRU cache, XML/JATS/SPL parsers and rate limits. Every result returns with its own identifier: PMID, NCT or DOI. No model sits in this path; nothing is invented." width="100%">
+</picture>
 
 Each tool file exports a `register*Tool(server)` function with a zod schema and an async handler. All network calls are rate-limited, cached, and time-bounded. See [`CLAUDE.md`](CLAUDE.md) for a full architecture walkthrough and [`CONTRIBUTING.md`](CONTRIBUTING.md) to add a tool.
 
@@ -248,6 +238,20 @@ Versions follow [Semantic Versioning](https://semver.org). See the [**CHANGELOG*
 
 Contributions are welcome and appreciated — bug reports, new data sources, new tools. Read the [contributing guide](CONTRIBUTING.md) to get started, then [open an issue](https://github.com/nickjlamb/pubcrawl/issues/new/choose) or a pull request.
 
+## 📚 Citation
+
+If PubCrawl supports work you publish, please cite it — see [`CITATION.cff`](CITATION.cff), or:
+
+```bibtex
+@software{lamb_pubcrawl,
+  author = {Lamb, Nick},
+  title  = {PubCrawl: verifiable biomedical literature, drug labelling and clinical trials for AI assistants},
+  url    = {https://github.com/nickjlamb/pubcrawl}
+}
+```
+
+---
+
 ## 📄 License
 
 [MIT](LICENSE) © [PharmaTools.AI](https://pharmatools.ai)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pharmatools/pubcrawl",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "MCP server for PubMed & Europe PMC literature search, US/UK drug labelling, and clinical trials — built by PharmaTools.AI",
   "mcpName": "io.github.nickjlamb/pubcrawl",
   "author": "PharmaTools.AI",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/nickjlamb/pubcrawl",
     "source": "github"
   },
-  "version": "2.5.0",
+  "version": "2.5.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@pharmatools/pubcrawl",
-      "version": "2.5.0",
+      "version": "2.5.1",
       "transport": {
         "type": "stdio"
       },