@djmima/pubmed-mcp 0.0.0-stage → 1.0.0

package/dist/server.js

@@ -0,0 +1,157 @@
+/**
+ * MCP server setup and tool registration.
+ *
+ * All seven PubMed tools are registered here. Each tool handler calls
+ * the appropriate function from src/tools/, catches errors, and returns
+ * a text content block (never throws — MCP protocol requires graceful errors).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { NcbiClient } from './pubmed/client.js';
+import { searchArticlesSchema, searchArticles, } from './tools/searchArticles.js';
+import { getArticleMetadataSchema, getArticleMetadata, } from './tools/getArticleMetadata.js';
+import { findRelatedArticlesSchema, findRelatedArticles, } from './tools/findRelatedArticles.js';
+import { lookupArticleByCitationSchema, lookupArticleByCitation, } from './tools/lookupArticleByCitation.js';
+import { convertArticleIdsSchema, convertArticleIds, } from './tools/convertArticleIds.js';
+import { getFullTextArticleSchema, getFullTextArticle, } from './tools/getFullTextArticle.js';
+import { getCopyrightStatusSchema, getCopyrightStatus, } from './tools/getCopyrightStatus.js';
+/**
+ * Create and return a configured MCP server instance.
+ *
+ * @param client NCBI client used by every tool. Rate limiting is per client,
+ *   so pass one shared client when creating several servers (HTTP mode
+ *   creates one per request). Defaults to a new client.
+ */
+export function createServer(client = new NcbiClient()) {
+    const server = new McpServer({
+        name: 'pubmed',
+        version: '1.0.0',
+    });
+    // ── search_articles ──────────────────────────────────────────────────────
+    server.tool('search_articles', 'Search PubMed for biomedical articles. Returns PMIDs and result set metadata. ' +
+        'Untagged terms undergo automatic term mapping (ATM); use field to restrict all ' +
+        'untagged terms to one PubMed field. Explicit field tags in the query take ' +
+        'precedence for tagged terms. Before concluding that a low or zero count means ' +
+        'no literature exists, inspect query_translation, warnings, and errors. To search ' +
+        'multiple words reliably in one field, tag each term; when a quoted phrase is not ' +
+        'indexed, use a proximity search such as [ti:~0] or [tiab:~0]. ' +
+        'Use get_article_metadata to retrieve full details for the returned PMIDs.', searchArticlesSchema, async (params) => {
+        try {
+            const result = await searchArticles(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return { content: [{ type: 'text', text: formatError(err, 'search_articles') }] };
+        }
+    });
+    // ── get_article_metadata ─────────────────────────────────────────────────
+    server.tool('get_article_metadata', 'Retrieve complete metadata for up to 200 PubMed articles by PMID. ' +
+        'Returns title, abstract, authors, journal info, ' +
+        'publication date, MeSH terms, keywords, and article type for each article. ' +
+        'Affiliations are left out unless include_affiliations is true. ' +
+        'Long author lists use a lot of context: set authors ' +
+        '(first_last, first, none) to return fewer; ' +
+        'author_count always gives the full number of authors. ' +
+        'PMIDs that PubMed does not return are left out of articles, so compare count ' +
+        'with the number of PMIDs requested.', getArticleMetadataSchema, async (params) => {
+        try {
+            const result = await getArticleMetadata(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: formatError(err, 'get_article_metadata') }],
+            };
+        }
+    });
+    // ── find_related_articles ────────────────────────────────────────────────
+    server.tool('find_related_articles', 'Find articles related to one or more PubMed articles using NCBI ELink. ' +
+        'Supports similar articles, PMC articles that cite the source, ' +
+        'and cross-database links to NCBI Gene, Protein, or Nucleotide databases. ' +
+        'Returned links are IDs in the target database: PMIDs for similar_articles, ' +
+        'numeric PMC IDs without the "PMC" prefix for citing_pmc_articles (convert them ' +
+        'with convert_article_ids, id_type pmcid), and Gene or RefSeq record IDs for ' +
+        'the linked_* types.', findRelatedArticlesSchema, async (params) => {
+        try {
+            const result = await findRelatedArticles(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: formatError(err, 'find_related_articles') }],
+            };
+        }
+    });
+    // ── lookup_article_by_citation ────────────────────────────────────────────
+    server.tool('lookup_article_by_citation', 'Look up PubMed IDs for articles given structured citation information ' +
+        '(journal, year, volume, first page, first author). ' +
+        'Useful for verifying references or resolving citations found in manuscripts. ' +
+        'Each result echoes its key; pmid is an empty string when no article matched.', lookupArticleByCitationSchema, async (params) => {
+        try {
+            const result = await lookupArticleByCitation(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [
+                    { type: 'text', text: formatError(err, 'lookup_article_by_citation') },
+                ],
+            };
+        }
+    });
+    // ── convert_article_ids ──────────────────────────────────────────────────
+    server.tool('convert_article_ids', 'Convert article identifiers between PMID, PMCID, and DOI formats. ' +
+        'For example, convert a list of PMIDs to DOIs, or find the PMCID for a DOI. ' +
+        'Uses the NCBI PMC ID Converter service, up to 200 IDs per request. ' +
+        'IDs it cannot convert come back as records with errmsg set.', convertArticleIdsSchema, async (params) => {
+        try {
+            const result = await convertArticleIds(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: formatError(err, 'convert_article_ids') }],
+            };
+        }
+    });
+    // ── get_full_text_article ────────────────────────────────────────────────
+    server.tool('get_full_text_article', 'Retrieve the full text of articles from PubMed Central (PMC). ' +
+        'Returns the complete article body including all sections, figure captions, ' +
+        'table captions, and references as plain text. ' +
+        'Full text is available for PMC articles whose publisher allows full-text ' +
+        'download; unavailable articles are reported in the errors array. ' +
+        'Starting from PMIDs, get_copyright_status returns each pmcid and has_full_text.', getFullTextArticleSchema, async (params) => {
+        try {
+            const result = await getFullTextArticle(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: formatError(err, 'get_full_text_article') }],
+            };
+        }
+    });
+    // ── get_copyright_status ─────────────────────────────────────────────────
+    server.tool('get_copyright_status', 'Check the copyright and open-access status for PubMed articles. ' +
+        'has_full_text: true means get_full_text_article can return the article text; ' +
+        'it is false for articles not in PMC and for PMC articles whose publisher ' +
+        'does not allow full-text download. Also reports the license (e.g., CC BY, ' +
+        'CC BY-NC-ND), copyright statement, and whether PMC marks the article open access.', getCopyrightStatusSchema, async (params) => {
+        try {
+            const result = await getCopyrightStatus(params, client);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: formatError(err, 'get_copyright_status') }],
+            };
+        }
+    });
+    return server;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function formatError(err, tool) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[${tool}] Error: ${message}\n`);
+    return JSON.stringify({ error: `Error occurred during tool execution: ${message}` });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/convertArticleIds.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool: convert_article_ids
+ *
+ * Convert between different article identifier types: PMID, PMCID, and DOI.
+ * Uses the NCBI PMC ID Converter API.
+ */
+import { z } from 'zod';
+import type { NcbiClient } from '../pubmed/client.js';
+import type { ConvertArticleIdsResponse } from '../pubmed/types.js';
+/** IDs per request; the CLI splits longer lists into batches of this size. */
+export declare const MAX_CONVERT_IDS = 200;
+export declare const convertArticleIdsSchema: {
+    ids: z.ZodArray<z.ZodString>;
+    id_type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        pmid: "pmid";
+        pmcid: "pmcid";
+        doi: "doi";
+    }>>>;
+};
+export type ConvertArticleIdsParams = {
+    ids: string[];
+    id_type?: 'pmid' | 'pmcid' | 'doi';
+};
+export declare function convertArticleIds(params: ConvertArticleIdsParams, client: NcbiClient): Promise<ConvertArticleIdsResponse>;
+//# sourceMappingURL=convertArticleIds.d.ts.map

package/dist/tools/convertArticleIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertArticleIds.d.ts","sourceRoot":"","sources":["../../src/tools/convertArticleIds.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,8EAA8E;AAC9E,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,uBAAuB;;;;;;;CAqBnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;CACpC,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAcpC"}

package/dist/tools/convertArticleIds.js

@@ -0,0 +1,39 @@
+/**
+ * Tool: convert_article_ids
+ *
+ * Convert between different article identifier types: PMID, PMCID, and DOI.
+ * Uses the NCBI PMC ID Converter API.
+ */
+import { z } from 'zod';
+/** IDs per request; the CLI splits longer lists into batches of this size. */
+export const MAX_CONVERT_IDS = 200;
+export const convertArticleIdsSchema = {
+    ids: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(MAX_CONVERT_IDS)
+        .describe('Array of article IDs to convert. ' +
+        'Format depends on id_type: PMIDs are numeric strings (e.g., "33526711"), ' +
+        'PMCIDs include the "PMC" prefix (e.g., "PMC7984072"), ' +
+        'DOIs are standard DOI strings (e.g., "10.1038/s41586-021-03819-2").'),
+    id_type: z
+        .enum(['pmid', 'pmcid', 'doi'])
+        .default('pmid')
+        .optional()
+        .describe('Type of the input IDs:\n' +
+        '  pmid  — PubMed IDs (default)\n' +
+        '  pmcid — PubMed Central IDs (with or without "PMC" prefix)\n' +
+        '  doi   — Digital Object Identifiers'),
+};
+export async function convertArticleIds(params, client) {
+    const idType = params.id_type ?? 'pmid';
+    // PMCIDs may come with or without the "PMC" prefix.
+    // The NCBI ID Converter API accepts both, but let's normalise.
+    const ids = idType === 'pmcid'
+        ? params.ids.map((id) => (id.toUpperCase().startsWith('PMC') ? id : `PMC${id}`))
+        : params.ids;
+    const response = await client.idConvert({ ids, idtype: idType });
+    // Pass through the NCBI response shape, which already matches our type
+    return response;
+}
+//# sourceMappingURL=convertArticleIds.js.map

package/dist/tools/convertArticleIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertArticleIds.js","sourceRoot":"","sources":["../../src/tools/convertArticleIds.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,eAAe,CAAC;SACpB,QAAQ,CACP,mCAAmC;QACjC,2EAA2E;QAC3E,wDAAwD;QACxD,qEAAqE,CACxE;IACH,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;SAC9B,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,EAAE;SACV,QAAQ,CACP,0BAA0B;QACxB,kCAAkC;QAClC,+DAA+D;QAC/D,sCAAsC,CACzC;CACJ,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA+B,EAC/B,MAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;IAExC,oDAAoD;IACpD,+DAA+D;IAC/D,MAAM,GAAG,GACP,MAAM,KAAK,OAAO;QAChB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAEjB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjE,uEAAuE;IACvE,OAAO,QAAqC,CAAC;AAC/C,CAAC"}

package/dist/tools/findRelatedArticles.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tool: find_related_articles
+ *
+ * Find articles related to one or more PubMed articles using NCBI's ELink
+ * service. Supports cross-database links (PubMed→PubMed, PubMed→PMC, etc.).
+ */
+import { z } from 'zod';
+import type { NcbiClient } from '../pubmed/client.js';
+import type { FindRelatedArticlesResponse } from '../pubmed/types.js';
+declare const LINK_TYPES: readonly ["similar_articles", "citing_pmc_articles", "linked_gene_records", "linked_refseq_proteins", "linked_refseq_nucleotides"];
+export type FindRelatedLinkType = (typeof LINK_TYPES)[number];
+export declare const findRelatedArticlesSchema: {
+    pmids: z.ZodArray<z.ZodString>;
+    link_type: z.ZodDefault<z.ZodEnum<{
+        similar_articles: "similar_articles";
+        citing_pmc_articles: "citing_pmc_articles";
+        linked_gene_records: "linked_gene_records";
+        linked_refseq_proteins: "linked_refseq_proteins";
+        linked_refseq_nucleotides: "linked_refseq_nucleotides";
+    }>>;
+    max_results: z.ZodOptional<z.ZodNumber>;
+};
+export type FindRelatedArticlesParams = {
+    pmids: string[];
+    link_type?: FindRelatedLinkType;
+    max_results?: number;
+};
+export declare function findRelatedArticles(params: FindRelatedArticlesParams, client: NcbiClient): Promise<FindRelatedArticlesResponse>;
+export {};
+//# sourceMappingURL=findRelatedArticles.d.ts.map

package/dist/tools/findRelatedArticles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findRelatedArticles.d.ts","sourceRoot":"","sources":["../../src/tools/findRelatedArticles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAW,MAAM,oBAAoB,CAAC;AAE/E,QAAA,MAAM,UAAU,oIAMN,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB;;;;;;;;;;CA0BrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAWF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,2BAA2B,CAAC,CAiCtC"}

package/dist/tools/findRelatedArticles.js

@@ -0,0 +1,77 @@
+/**
+ * Tool: find_related_articles
+ *
+ * Find articles related to one or more PubMed articles using NCBI's ELink
+ * service. Supports cross-database links (PubMed→PubMed, PubMed→PMC, etc.).
+ */
+import { z } from 'zod';
+const LINK_TYPES = [
+    'similar_articles',
+    'citing_pmc_articles',
+    'linked_gene_records',
+    'linked_refseq_proteins',
+    'linked_refseq_nucleotides',
+];
+export const findRelatedArticlesSchema = {
+    pmids: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe('Array of source PubMed IDs to find related articles for.'),
+    link_type: z
+        .enum(LINK_TYPES)
+        .default('similar_articles')
+        .describe('Type of link to follow:\n' +
+        '  similar_articles           — computationally similar PubMed articles (default)\n' +
+        '  citing_pmc_articles        — PMC articles that cite the source article\n' +
+        '  linked_gene_records        — linked NCBI Gene records\n' +
+        '  linked_refseq_proteins     — linked RefSeq protein records\n' +
+        '  linked_refseq_nucleotides  — linked RefSeq nucleotide records'),
+    max_results: z
+        .number()
+        .int()
+        .min(1)
+        .max(1000)
+        .optional()
+        .describe('Maximum number of related article IDs to return per source article. ' +
+        'Note: NCBI does not natively limit ELink results; this is a client-side cap.'),
+};
+// Mapping from tool link_type values to NCBI elink linkname values
+const LINK_TYPE_MAP = {
+    similar_articles: 'pubmed_pubmed',
+    citing_pmc_articles: 'pubmed_pmc_refs',
+    linked_gene_records: 'pubmed_gene',
+    linked_refseq_proteins: 'pubmed_protein_refseq',
+    linked_refseq_nucleotides: 'pubmed_nuccore_refseq',
+};
+export async function findRelatedArticles(params, client) {
+    const linkname = LINK_TYPE_MAP[params.link_type ?? 'similar_articles'];
+    const response = await client.elink({
+        dbfrom: 'pubmed',
+        id: params.pmids,
+        linkname,
+        cmd: 'neighbor',
+    });
+    const maxResults = params.max_results;
+    const linksets = (response.linksets ?? []).map((ls) => ({
+        dbfrom: ls.dbfrom,
+        ids: ls.ids,
+        linksetdbs: (ls.linksetdbs ?? []).map((lsdb) => {
+            // Transform link objects to plain PMID strings and optionally cap results
+            let links = lsdb.links.map((link) => {
+                if (typeof link === 'string')
+                    return link;
+                return link.id;
+            });
+            if (maxResults !== undefined) {
+                links = links.slice(0, maxResults);
+            }
+            return {
+                dbto: lsdb.dbto,
+                linkname: lsdb.linkname,
+                links,
+            };
+        }),
+    }));
+    return { linksets };
+}
+//# sourceMappingURL=findRelatedArticles.js.map

package/dist/tools/findRelatedArticles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findRelatedArticles.js","sourceRoot":"","sources":["../../src/tools/findRelatedArticles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,GAAG;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IACrB,wBAAwB;IACxB,2BAA2B;CACnB,CAAC;AAGX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,0DAA0D,CAAC;IACvE,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,UAAU,CAAC;SAChB,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,CACP,2BAA2B;QACzB,oFAAoF;QACpF,4EAA4E;QAC5E,2DAA2D;QAC3D,gEAAgE;QAChE,iEAAiE,CACpE;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE;QACpE,8EAA8E,CACjF;CACJ,CAAC;AAQF,mEAAmE;AACnE,MAAM,aAAa,GAAwC;IACzD,gBAAgB,EAAE,eAAe;IACjC,mBAAmB,EAAE,iBAAiB;IACtC,mBAAmB,EAAE,aAAa;IAClC,sBAAsB,EAAE,uBAAuB;IAC/C,yBAAyB,EAAE,uBAAuB;CACnD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiC,EACjC,MAAkB;IAElB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,EAAE,QAAQ;QAChB,EAAE,EAAE,MAAM,CAAC,KAAK;QAChB,QAAQ;QACR,GAAG,EAAE,UAAU;KAChB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;IAEtC,MAAM,QAAQ,GAAc,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,GAAG,EAAE,EAAE,CAAC,GAAG;QACX,UAAU,EAAE,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAoB,EAAE,EAAE;YAC7D,0EAA0E;YAC1E,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAClC,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBAC1C,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;YACH,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACrC,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;aACN,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/tools/getArticleMetadata.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool: get_article_metadata
+ *
+ * Retrieve full metadata (title, abstract, authors, MeSH terms, etc.) for one
+ * or more PubMed articles identified by their PMIDs.
+ */
+import { z } from 'zod';
+import type { NcbiClient } from '../pubmed/client.js';
+import type { GetArticleMetadataResponse } from '../pubmed/types.js';
+/** PMIDs per request; the CLI splits longer lists into batches of this size. */
+export declare const MAX_METADATA_PMIDS = 200;
+declare const AUTHOR_MODES: readonly ["all", "first_last", "first", "none"];
+export type AuthorMode = (typeof AUTHOR_MODES)[number];
+export declare const getArticleMetadataSchema: {
+    pmids: z.ZodArray<z.ZodString>;
+    authors: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        first_last: "first_last";
+        first: "first";
+        none: "none";
+    }>>;
+    include_affiliations: z.ZodDefault<z.ZodBoolean>;
+};
+export type GetArticleMetadataParams = {
+    pmids: string[];
+    authors?: AuthorMode;
+    include_affiliations?: boolean;
+};
+export declare function getArticleMetadata(params: GetArticleMetadataParams, client: NcbiClient): Promise<GetArticleMetadataResponse>;
+export {};
+//# sourceMappingURL=getArticleMetadata.d.ts.map

package/dist/tools/getArticleMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArticleMetadata.d.ts","sourceRoot":"","sources":["../../src/tools/getArticleMetadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAiB,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAIpF,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,QAAA,MAAM,YAAY,iDAAkD,CAAC;AACrE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,wBAAwB;;;;;;;;;CA4BpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAqBF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,0BAA0B,CAAC,CAuBrC"}

package/dist/tools/getArticleMetadata.js

@@ -0,0 +1,72 @@
+/**
+ * Tool: get_article_metadata
+ *
+ * Retrieve full metadata (title, abstract, authors, MeSH terms, etc.) for one
+ * or more PubMed articles identified by their PMIDs.
+ */
+import { z } from 'zod';
+import { IMPORTANT_LEGAL_NOTICE } from '../pubmed/types.js';
+import { parsePubmedEfetchXml } from '../utils/xml.js';
+/** PMIDs per request; the CLI splits longer lists into batches of this size. */
+export const MAX_METADATA_PMIDS = 200;
+const AUTHOR_MODES = ['all', 'first_last', 'first', 'none'];
+export const getArticleMetadataSchema = {
+    pmids: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(MAX_METADATA_PMIDS)
+        .describe('Array of PubMed IDs (PMIDs) to retrieve metadata for. ' +
+        `Maximum ${MAX_METADATA_PMIDS} PMIDs per request.`),
+    authors: z
+        .enum(AUTHOR_MODES)
+        .default('all')
+        .describe('Which authors to return, to save context on long author lists:\n' +
+        '  all        — every author (default)\n' +
+        '  first_last — the first and last author (the last is usually the senior author)\n' +
+        '  first      — the first author only\n' +
+        '  none       — no authors\n' +
+        'author_count always gives the full number of authors.'),
+    include_affiliations: z
+        .boolean()
+        .default(false)
+        .describe('Include the affiliations of each returned author (default false). ' +
+        'Affiliations are repeated per author and often take most of the space; ' +
+        'set true to get them.'),
+};
+function selectAuthors(authors, mode) {
+    switch (mode) {
+        case 'all':
+            return authors;
+        case 'first_last':
+            return authors.length > 1 ? [authors[0], authors[authors.length - 1]] : authors;
+        case 'first':
+            return authors.slice(0, 1);
+        case 'none':
+            return [];
+    }
+}
+function withoutAffiliations(author) {
+    const copy = { ...author };
+    delete copy.affiliations;
+    return copy;
+}
+export async function getArticleMetadata(params, client) {
+    const xml = await client.efetch({
+        db: 'pubmed',
+        id: params.pmids,
+        retmode: 'xml',
+        rettype: 'abstract',
+    });
+    const mode = params.authors ?? 'all';
+    const includeAffiliations = params.include_affiliations ?? false;
+    const articles = parsePubmedEfetchXml(xml).map((article) => ({
+        ...article,
+        authors: selectAuthors(article.authors, mode).map((author) => includeAffiliations ? author : withoutAffiliations(author)),
+    }));
+    return {
+        articles,
+        count: articles.length,
+        important_legal_notice: IMPORTANT_LEGAL_NOTICE,
+    };
+}
+//# sourceMappingURL=getArticleMetadata.js.map

package/dist/tools/getArticleMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArticleMetadata.js","sourceRoot":"","sources":["../../src/tools/getArticleMetadata.ts"],"names":[],"mappings":"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"}

package/dist/tools/getCopyrightStatus.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool: get_copyright_status
+ *
+ * Check copyright and open-access status for PubMed articles.
+ * Maps PMIDs to PMCIDs with the NCBI ID Converter, then reads PMC's own
+ * access metadata from E-utilities EFetch (db=pmc). The PMC OA Web Service
+ * previously used here was retired by NCBI on 2026-08-25.
+ *
+ * has_full_text means get_full_text_article can return text for the article.
+ * It is false for PubMed-only articles and for PMC articles whose publisher
+ * does not allow full-text XML download.
+ */
+import { z } from 'zod';
+import type { NcbiClient } from '../pubmed/client.js';
+import type { GetCopyrightStatusResponse } from '../pubmed/types.js';
+/** PMIDs per request; the CLI splits longer lists into batches of this size. */
+export declare const MAX_COPYRIGHT_PMIDS = 50;
+export declare const getCopyrightStatusSchema: {
+    pmids: z.ZodArray<z.ZodString>;
+};
+export type GetCopyrightStatusParams = {
+    pmids: string[];
+};
+export declare function getCopyrightStatus(params: GetCopyrightStatusParams, client: NcbiClient): Promise<GetCopyrightStatusResponse>;
+//# sourceMappingURL=getCopyrightStatus.d.ts.map

package/dist/tools/getCopyrightStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCopyrightStatus.d.ts","sourceRoot":"","sources":["../../src/tools/getCopyrightStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,0BAA0B,EAAmB,MAAM,oBAAoB,CAAC;AAGtF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAO,MAAM,wBAAwB;;CAMpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAKF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,0BAA0B,CAAC,CA4DrC"}

package/dist/tools/getCopyrightStatus.js

@@ -0,0 +1,84 @@
+/**
+ * Tool: get_copyright_status
+ *
+ * Check copyright and open-access status for PubMed articles.
+ * Maps PMIDs to PMCIDs with the NCBI ID Converter, then reads PMC's own
+ * access metadata from E-utilities EFetch (db=pmc). The PMC OA Web Service
+ * previously used here was retired by NCBI on 2026-08-25.
+ *
+ * has_full_text means get_full_text_article can return text for the article.
+ * It is false for PubMed-only articles and for PMC articles whose publisher
+ * does not allow full-text XML download.
+ */
+import { z } from 'zod';
+import { parsePmcAccessXml } from '../utils/xml.js';
+/** PMIDs per request; the CLI splits longer lists into batches of this size. */
+export const MAX_COPYRIGHT_PMIDS = 50;
+export const getCopyrightStatusSchema = {
+    pmids: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(MAX_COPYRIGHT_PMIDS)
+        .describe('Array of PubMed IDs (PMIDs) to check copyright status for.'),
+};
+/** Open-access articles come back as full JATS XML, so keep each EFetch modest. */
+const EFETCH_BATCH_SIZE = 20;
+export async function getCopyrightStatus(params, client) {
+    // Step 1: Convert PMIDs to PMCIDs using the ID Converter
+    const convResponse = await client.idConvert({
+        ids: params.pmids,
+        idtype: 'pmid',
+    });
+    // Build a map: pmid → pmcid (may be undefined if not in PMC)
+    const pmidToPmcid = new Map();
+    for (const record of convResponse.records) {
+        const pmid = record.pmid ?? record['requested-id'];
+        if (pmid) {
+            pmidToPmcid.set(String(pmid), record.pmcid);
+        }
+    }
+    // Step 2: Fetch PMC records in batches and read their access metadata.
+    // Batches run sequentially so large inputs respect NCBI rate limits.
+    const pmcids = [
+        ...new Set(params.pmids.map((pmid) => pmidToPmcid.get(pmid)).filter(isString)),
+    ];
+    const accessByPmcid = new Map();
+    for (let i = 0; i < pmcids.length; i += EFETCH_BATCH_SIZE) {
+        const batch = pmcids.slice(i, i + EFETCH_BATCH_SIZE);
+        const xml = await client.efetch({
+            db: 'pmc',
+            id: batch.map((pmcid) => pmcid.replace(/^PMC/i, '')),
+            retmode: 'xml',
+        });
+        for (const info of parsePmcAccessXml(xml)) {
+            accessByPmcid.set(info.pmcid.toUpperCase(), info);
+        }
+    }
+    const statuses = params.pmids.map((pmid) => {
+        const pmcid = pmidToPmcid.get(pmid);
+        if (!pmcid) {
+            return { pmid, has_full_text: false };
+        }
+        const info = accessByPmcid.get(pmcid.toUpperCase());
+        if (!info) {
+            // In PMC per the ID Converter, but EFetch returned no record for it.
+            return { pmid, pmcid, has_full_text: false };
+        }
+        return {
+            pmid,
+            pmcid,
+            has_full_text: info.hasFullText,
+            ...(info.license ? { license: info.license } : {}),
+            ...(info.copyrightStatement ? { copyright_statement: info.copyrightStatement } : {}),
+            is_open_access: info.isOpenAccess,
+        };
+    });
+    return {
+        statuses,
+        count: statuses.length,
+    };
+}
+function isString(value) {
+    return typeof value === 'string' && value !== '';
+}
+//# sourceMappingURL=getCopyrightStatus.js.map

package/dist/tools/getCopyrightStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCopyrightStatus.js","sourceRoot":"","sources":["../../src/tools/getCopyrightStatus.ts"],"names":[],"mappings":"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"}

package/dist/tools/getFullTextArticle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool: get_full_text_article
+ *
+ * Retrieve the full text of articles from PubMed Central (PMC).
+ * Full text is available for PMC articles whose publisher allows full-text
+ * download (the same test get_copyright_status uses for has_full_text).
+ * Articles not in PMC will return an error entry.
+ */
+import { z } from 'zod';
+import type { NcbiClient } from '../pubmed/client.js';
+import type { GetFullTextArticleResponse } from '../pubmed/types.js';
+/** PMCIDs per request; the CLI splits longer lists into batches of this size. */
+export declare const MAX_FULL_TEXT_IDS = 20;
+export declare const getFullTextArticleSchema: {
+    pmc_ids: z.ZodArray<z.ZodString>;
+};
+export type GetFullTextArticleParams = {
+    pmc_ids: string[];
+};
+export declare function getFullTextArticle(params: GetFullTextArticleParams, client: NcbiClient): Promise<GetFullTextArticleResponse>;
+//# sourceMappingURL=getFullTextArticle.d.ts.map

package/dist/tools/getFullTextArticle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFullTextArticle.d.ts","sourceRoot":"","sources":["../../src/tools/getFullTextArticle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,0BAA0B,EAAmB,MAAM,oBAAoB,CAAC;AAItF,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,wBAAwB;;CAWpC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAYF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,0BAA0B,CAAC,CA6DrC"}