@cyanheads/orcid-mcp-server 0.1.5 → 0.2.0

package/dist/mcp-server/tools/definitions/get-research-resources.tool.js

@@ -0,0 +1,157 @@
+/**
+ * @fileoverview List research resources (equipment, facilities, compute allocations, etc.)
+ * associated with an ORCID researcher.
+ * @module mcp-server/tools/definitions/get-research-resources
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService, normalizeOrcidId } from '../../../services/orcid/orcid-service.js';
+const ExternalIdSchema = z
+    .object({
+    type: z.string().describe('Identifier type (e.g. uri, doi, grant_number).'),
+    value: z.string().describe('Identifier value.'),
+    url: z.string().optional().describe('Resolver URL for this identifier, if available.'),
+    relationship: z.string().optional().describe('Relationship to the resource (self or part-of).'),
+})
+    .describe('External identifier for the research resource.');
+const OrgSchema = z
+    .object({
+    name: z.string().optional().describe('Organization name.'),
+    city: z.string().optional().describe('City of the organization.'),
+    country: z.string().optional().describe('Country code of the organization.'),
+    disambiguatedId: z
+        .string()
+        .optional()
+        .describe('Disambiguated organization ID (e.g. ROR or GRID identifier).'),
+    disambiguationSource: z
+        .string()
+        .optional()
+        .describe('Source of the disambiguation ID (e.g. ROR, GRID, RINGGOLD).'),
+})
+    .describe('Hosting organization for the research resource.');
+export const orcidGetResearchResources = tool('orcid_get_research_resources', {
+    title: 'Get ORCID Research Resources',
+    description: 'List research resources associated with an ORCID researcher — compute allocations, equipment access, lab facilities, data resources, and clinical study registrations. This is a newer ORCID section; most researchers have no entries. Returns the resource title, hosting organization, external identifiers (often a URI to the allocation portal), and access period. Most entries are deposited by resource-allocation systems (e.g. ACCESS, XSEDE) rather than researchers themselves.',
+    annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
+    input: z.object({
+        orcid_id: z
+            .string()
+            .regex(/^(https?:\/\/orcid\.org\/)?\d{4}-\d{4}-\d{4}-\d{3}[\dX]$/, 'Must be a valid ORCID iD (e.g. 0000-0001-2345-6789) or full ORCID URI.')
+            .describe('ORCID iD — bare format (0000-0001-2345-6789) or full URI (https://orcid.org/0000-0001-2345-6789).'),
+    }),
+    output: z.object({
+        orcidId: z.string().describe('Normalized ORCID iD (bare format).'),
+        orcidUri: z.string().describe('Full ORCID URI.'),
+        resourceCount: z.number().describe('Total number of research resources returned.'),
+        resources: z
+            .array(z
+            .object({
+            putCode: z.number().describe('Put-code of this research resource record.'),
+            title: z.string().optional().describe('Resource or proposal title.'),
+            hostOrganization: OrgSchema.optional().describe('Organization that hosts or manages the resource.'),
+            externalIds: z
+                .array(ExternalIdSchema)
+                .describe('External identifiers for the resource (often a portal URI).'),
+            startDate: z
+                .string()
+                .optional()
+                .describe('Access or allocation start date (YYYY, YYYY-MM, or YYYY-MM-DD).'),
+            endDate: z
+                .string()
+                .optional()
+                .describe('Access or allocation end date (YYYY, YYYY-MM, or YYYY-MM-DD).'),
+            url: z.string().optional().describe('URL for the resource or allocation record.'),
+        })
+            .describe('Research resource record.'))
+            .describe('Research resources associated with this ORCID iD.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Note when no research resources are found — this section is sparsely populated across ORCID profiles.'),
+    },
+    errors: [
+        {
+            reason: 'profile_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ORCID iD does not correspond to a registered researcher.',
+            recovery: 'Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_get_research_resources', { orcidId: input.orcid_id });
+        let resources;
+        try {
+            resources = await service.getResearchResources(input.orcid_id, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('profile_not_found', `ORCID iD ${normalizeOrcidId(input.orcid_id)} not found`);
+            }
+            throw err;
+        }
+        const bareId = normalizeOrcidId(input.orcid_id);
+        ctx.log.info('orcid_get_research_resources completed', {
+            orcidId: bareId,
+            resourceCount: resources.length,
+        });
+        if (resources.length === 0) {
+            ctx.enrich.notice('No research resources found. This ORCID section is sparsely populated — most researchers have no entries. Resources are typically deposited by allocation systems (e.g. ACCESS, XSEDE) rather than self-reported.');
+        }
+        return {
+            orcidId: bareId,
+            orcidUri: `https://orcid.org/${bareId}`,
+            resourceCount: resources.length,
+            resources,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Research Resources for ORCID ${result.orcidId}`,
+            `**URI:** ${result.orcidUri}`,
+            `**Total Resources:** ${result.resourceCount}`,
+        ];
+        if (result.resources.length === 0) {
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        lines.push('');
+        for (const r of result.resources) {
+            lines.push(`### ${r.title ?? '(untitled)'}`);
+            lines.push(`**Put-code:** ${r.putCode}`);
+            if (r.hostOrganization) {
+                const org = r.hostOrganization;
+                const parts = [];
+                if (org.name)
+                    parts.push(org.name);
+                if (org.city)
+                    parts.push(org.city);
+                if (org.country)
+                    parts.push(org.country);
+                if (parts.length)
+                    lines.push(`**Host:** ${parts.join(', ')}`);
+                if (org.disambiguatedId) {
+                    lines.push(`**Host ID:** ${org.disambiguatedId} (${org.disambiguationSource ?? 'unknown source'})`);
+                }
+            }
+            if (r.startDate || r.endDate) {
+                const period = [r.startDate, r.endDate].filter(Boolean).join(' – ');
+                lines.push(`**Period:** ${period}`);
+            }
+            if (r.url)
+                lines.push(`**URL:** ${r.url}`);
+            if (r.externalIds.length) {
+                const idParts = r.externalIds.map((id) => {
+                    const rel = id.relationship ? ` [${id.relationship}]` : '';
+                    const urlPart = id.url ? ` (${id.url})` : '';
+                    return `${id.type}:${id.value}${urlPart}${rel}`;
+                });
+                lines.push(`**IDs:** ${idParts.join(', ')}`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-research-resources.tool.js.map

package/dist/mcp-server/tools/definitions/get-research-resources.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-work-detail.tool.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Fetch the full detail record for a single ORCID work by its put-code.
+ * @module mcp-server/tools/definitions/get-work-detail
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const orcidGetWorkDetail: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    orcid_id: z.ZodString;
+    put_code: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    orcidId: z.ZodString;
+    orcidUri: z.ZodString;
+    putCode: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    workType: z.ZodOptional<z.ZodString>;
+    publicationDate: z.ZodOptional<z.ZodString>;
+    journalTitle: z.ZodOptional<z.ZodString>;
+    abstract: z.ZodOptional<z.ZodString>;
+    citation: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    url: z.ZodOptional<z.ZodString>;
+    externalIds: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        value: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        relationship: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    contributors: z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        orcidId: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        sequence: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    languageCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "work_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The ORCID iD or put-code does not correspond to a known record.";
+    readonly recovery: "Verify the ORCID iD with orcid_search_researchers and the put-code with orcid_get_works.";
+}], undefined>;
+//# sourceMappingURL=get-work-detail.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-work-detail.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-work-detail.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-work-detail.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AA8B3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAuJ7B,CAAC"}

package/dist/mcp-server/tools/definitions/get-work-detail.tool.js

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview Fetch the full detail record for a single ORCID work by its put-code.
+ * @module mcp-server/tools/definitions/get-work-detail
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService, normalizeOrcidId } from '../../../services/orcid/orcid-service.js';
+const ExternalIdSchema = z
+    .object({
+    type: z.string().describe('Identifier type (e.g. doi, pmid, arxiv, isbn, ppr).'),
+    value: z.string().describe('Identifier value.'),
+    url: z.string().optional().describe('Resolver URL for this identifier, if available.'),
+    relationship: z.string().optional().describe('Relationship to the work (self or part-of).'),
+})
+    .describe('External identifier for the work.');
+const ContributorSchema = z
+    .object({
+    name: z.string().optional().describe('Contributor display name or credit name.'),
+    orcidId: z.string().optional().describe('Contributor ORCID iD (bare format), if linked.'),
+    role: z
+        .string()
+        .optional()
+        .describe('Contributor role (e.g. author, editor, conceptualization, data-curation). May be a CRediT taxonomy term.'),
+    sequence: z
+        .string()
+        .optional()
+        .describe('Contributor sequence position (first or additional).'),
+})
+    .describe('Work contributor with optional role and ORCID iD.');
+export const orcidGetWorkDetail = tool('orcid_get_work_detail', {
+    title: 'Get ORCID Work Detail',
+    description: 'Fetch the full detail record for a single work by its put-code, which is returned by orcid_get_works in the put_code field of each work entry. Returns the abstract (short-description), all contributors with CRediT roles, the complete external ID list (DOI, PMID, arXiv, ISBN, etc.), citation metadata (BibTeX or other formats when provided), journal title, and URL. Use this when you need more than the summary — especially the abstract or contributor list — after calling orcid_get_works to identify the put-code.',
+    annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
+    input: z.object({
+        orcid_id: z
+            .string()
+            .regex(/^(https?:\/\/orcid\.org\/)?\d{4}-\d{4}-\d{4}-\d{3}[\dX]$/, 'Must be a valid ORCID iD (e.g. 0000-0001-2345-6789) or full ORCID URI.')
+            .describe('ORCID iD — bare format (0000-0001-2345-6789) or full URI (https://orcid.org/0000-0001-2345-6789).'),
+        put_code: z
+            .number()
+            .int()
+            .positive()
+            .describe('Work put-code, available in the put_code field returned by orcid_get_works. Each work group has a unique put-code.'),
+    }),
+    output: z.object({
+        orcidId: z.string().describe('Normalized ORCID iD (bare format).'),
+        orcidUri: z.string().describe('Full ORCID URI.'),
+        putCode: z.number().describe('Put-code of this work record.'),
+        title: z.string().optional().describe('Work title.'),
+        subtitle: z.string().optional().describe('Work subtitle, when provided.'),
+        workType: z
+            .string()
+            .optional()
+            .describe('Work type (e.g. journal-article, dataset, software, preprint).'),
+        publicationDate: z
+            .string()
+            .optional()
+            .describe('Publication date (YYYY, YYYY-MM, or YYYY-MM-DD).'),
+        journalTitle: z.string().optional().describe('Journal or container title, when provided.'),
+        abstract: z.string().optional().describe('Abstract or short description, when provided.'),
+        citation: z
+            .object({
+            type: z.string().describe('Citation format (e.g. bibtex, formatted-unspecified).'),
+            value: z.string().describe('Citation string in the specified format.'),
+        })
+            .optional()
+            .describe('Citation metadata, when provided by the depositing system.'),
+        url: z.string().optional().describe('URL for the work, when available.'),
+        externalIds: z
+            .array(ExternalIdSchema)
+            .describe('All external identifiers (DOIs, PMIDs, arXiv IDs, ISBNs, etc.).'),
+        contributors: z
+            .array(ContributorSchema)
+            .describe('Work contributors with optional roles. May be empty if not deposited.'),
+        languageCode: z.string().optional().describe('Language code of the work, when provided.'),
+    }),
+    errors: [
+        {
+            reason: 'work_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ORCID iD or put-code does not correspond to a known record.',
+            recovery: 'Verify the ORCID iD with orcid_search_researchers and the put-code with orcid_get_works.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_get_work_detail', { orcidId: input.orcid_id, putCode: input.put_code });
+        let detail;
+        try {
+            detail = await service.getWorkDetail(input.orcid_id, input.put_code, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('work_not_found', `Work put-code ${input.put_code} not found for ORCID iD ${normalizeOrcidId(input.orcid_id)}`);
+            }
+            throw err;
+        }
+        const bareId = normalizeOrcidId(input.orcid_id);
+        ctx.log.info('orcid_get_work_detail completed', {
+            orcidId: bareId,
+            putCode: detail.putCode,
+            hasAbstract: !!detail.abstract,
+            contributorCount: detail.contributors.length,
+        });
+        return {
+            orcidId: bareId,
+            orcidUri: `https://orcid.org/${bareId}`,
+            putCode: detail.putCode,
+            ...(detail.title !== undefined && { title: detail.title }),
+            ...(detail.subtitle !== undefined && { subtitle: detail.subtitle }),
+            ...(detail.workType !== undefined && { workType: detail.workType }),
+            ...(detail.publicationDate !== undefined && { publicationDate: detail.publicationDate }),
+            ...(detail.journalTitle !== undefined && { journalTitle: detail.journalTitle }),
+            ...(detail.abstract !== undefined && { abstract: detail.abstract }),
+            ...(detail.citation !== undefined && { citation: detail.citation }),
+            ...(detail.url !== undefined && { url: detail.url }),
+            externalIds: detail.externalIds,
+            contributors: detail.contributors,
+            ...(detail.languageCode !== undefined && { languageCode: detail.languageCode }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## ${result.title ?? '(untitled)'}`,
+            `**ORCID iD:** ${result.orcidId} | **URI:** ${result.orcidUri} | **Put-code:** ${result.putCode}`,
+        ];
+        if (result.subtitle)
+            lines.push(`**Subtitle:** ${result.subtitle}`);
+        if (result.workType)
+            lines.push(`**Type:** ${result.workType}`);
+        if (result.publicationDate)
+            lines.push(`**Date:** ${result.publicationDate}`);
+        if (result.journalTitle)
+            lines.push(`**Journal:** ${result.journalTitle}`);
+        if (result.url)
+            lines.push(`**URL:** ${result.url}`);
+        if (result.externalIds.length) {
+            const idParts = result.externalIds.map((id) => {
+                const rel = id.relationship ? ` [${id.relationship}]` : '';
+                const urlPart = id.url ? ` (${id.url})` : '';
+                return `${id.type}:${id.value}${urlPart}${rel}`;
+            });
+            lines.push(`**IDs:** ${idParts.join(', ')}`);
+        }
+        if (result.abstract) {
+            lines.push('', `**Abstract:** ${result.abstract}`);
+        }
+        if (result.contributors.length) {
+            lines.push('', '**Contributors:**');
+            for (const c of result.contributors) {
+                const name = c.name ?? '(unnamed)';
+                const role = c.role ? ` — ${c.role}` : '';
+                const seq = c.sequence ? ` (${c.sequence})` : '';
+                const orcid = c.orcidId ? ` [${c.orcidId}]` : '';
+                lines.push(`- ${name}${role}${seq}${orcid}`);
+            }
+        }
+        if (result.citation) {
+            lines.push('', `**Citation (${result.citation.type}):**`);
+            lines.push('```');
+            lines.push(result.citation.value);
+            lines.push('```');
+        }
+        if (result.languageCode)
+            lines.push(`**Language:** ${result.languageCode}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-work-detail.tool.js.map

package/dist/mcp-server/tools/definitions/get-work-detail.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-works.tool.d.ts

@@ -13,6 +13,7 @@ export declare const orcidGetWorks: import("@cyanheads/mcp-ts-core").ToolDefinit
     orcidUri: z.ZodString;
     workCount: z.ZodNumber;
     works: z.ZodArray<z.ZodObject<{
+        putCode: z.ZodOptional<z.ZodNumber>;
         title: z.ZodOptional<z.ZodString>;
         workType: z.ZodOptional<z.ZodString>;
         publicationDate: z.ZodOptional<z.ZodString>;
@@ -25,11 +26,12 @@ export declare const orcidGetWorks: import("@cyanheads/mcp-ts-core").ToolDefinit
             relationship: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    notice: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, readonly [{
     readonly reason: "profile_not_found";
     readonly code: JsonRpcErrorCode.NotFound;
     readonly when: "The ORCID iD does not correspond to a registered researcher.";
     readonly recovery: "Verify the ORCID iD is correct and try orcid_search_researchers to find valid iDs.";
-}]>;
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
 //# sourceMappingURL=get-works.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-works.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-works.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-works.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAa3E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;GAmIxB,CAAC"}
+{"version":3,"file":"get-works.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-works.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAa3E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2IxB,CAAC"}

package/dist/mcp-server/tools/definitions/get-works.tool.js

@@ -17,7 +17,7 @@ const ExternalIdSchema = z
     .describe('External identifier for a work.');
 export const orcidGetWorks = tool('orcid_get_works', {
     title: 'Get ORCID Researcher Works',
-    description: 'Retrieve works associated with an ORCID iD — publications, datasets, software, preprints, and more. Returns work summaries with titles, types, publication dates, journal names, and all external identifiers (DOIs, PMIDs, arXiv IDs, ISBNs). External IDs are ready for chaining to Crossref, PubMed, or arXiv servers. The /works endpoint returns summaries only — pass DOIs to Crossref or PMIDs to PubMed to retrieve full metadata or abstracts. Works are self-reported; a researcher may not have linked all their publications.',
+    description: 'Retrieve works associated with an ORCID iD — publications, datasets, software, preprints, and more. Returns work summaries with put-codes, titles, types, publication dates, journal names, and all external identifiers (DOIs, PMIDs, arXiv IDs, ISBNs). Pass the put_code from each work to orcid_get_work_detail to retrieve the full record including abstract and contributors. External IDs are ready for chaining to Crossref, PubMed, or arXiv servers. Works are self-reported; a researcher may not have linked all their publications.',
     annotations: { readOnlyHint: true, openWorldHint: false, idempotentHint: true },
     input: z.object({
         orcid_id: z
@@ -32,6 +32,10 @@ export const orcidGetWorks = tool('orcid_get_works', {
         works: z
             .array(z
             .object({
+            putCode: z
+                .number()
+                .optional()
+                .describe('Work put-code — pass to orcid_get_work_detail to fetch the full record including abstract and contributors.'),
             title: z.string().optional().describe('Work title.'),
             workType: z
                 .string()
@@ -49,11 +53,15 @@ export const orcidGetWorks = tool('orcid_get_works', {
         })
             .describe('Work summary record.'))
             .describe('Works associated with this ORCID iD.'),
+    }),
+    // Agent-facing context: empty-result notice surfaces in structuredContent and content[]
+    // without occupying the domain return.
+    enrichment: {
         notice: z
             .string()
             .optional()
             .describe('Note when the works list is empty — may indicate no self-reported works or private visibility settings.'),
-    }),
+    },
     errors: [
         {
             reason: 'profile_not_found',
@@ -77,15 +85,14 @@ export const orcidGetWorks = tool('orcid_get_works', {
         }
         const bareId = normalizeOrcidId(input.orcid_id);
         ctx.log.info('orcid_get_works completed', { orcidId: bareId, workCount: works.length });
-        const notice = works.length === 0
-            ? 'No works found. The researcher may not have linked works to their ORCID record, or works may be set to private visibility.'
-            : undefined;
+        if (works.length === 0) {
+            ctx.enrich.notice('No works found. The researcher may not have linked works to their ORCID record, or works may be set to private visibility.');
+        }
         return {
             orcidId: bareId,
             orcidUri: `https://orcid.org/${bareId}`,
             workCount: works.length,
             works,
-            ...(notice && { notice }),
         };
     },
     format: (result) => {
@@ -94,15 +101,14 @@ export const orcidGetWorks = tool('orcid_get_works', {
             `**URI:** ${result.orcidUri}`,
             `**Total Works:** ${result.workCount}`,
         ];
-        if (result.notice) {
-            lines.push('', `> ${result.notice}`);
-        }
         if (result.works.length === 0) {
             return [{ type: 'text', text: lines.join('\n') }];
         }
         lines.push('');
         for (const w of result.works) {
             lines.push(`### ${w.title ?? '(untitled)'}`);
+            if (w.putCode != null)
+                lines.push(`**Put-code:** ${w.putCode}`);
             if (w.workType)
                 lines.push(`**Type:** ${w.workType}`);
             if (w.publicationDate)

package/dist/mcp-server/tools/definitions/get-works.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-works.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-works.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGtF,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC3E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC/C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACtF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAC5F,CAAC;KACD,QAAQ,CAAC,iCAAiC,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,EAAE;IACnD,KAAK,EAAE,4BAA4B;IACnC,WAAW,EACT,2gBAA2gB;IAC7gB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE;IAE/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,KAAK,CACJ,0DAA0D,EAC1D,wEAAwE,CACzE;aACA,QAAQ,CACP,mGAAmG,CACpG;KACJ,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACjE,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACpD,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC3E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YACtE,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,gBAAgB,CAAC;iBACvB,QAAQ,CAAC,6DAA6D,CAAC;SAC3E,CAAC;aACD,QAAQ,CAAC,sBAAsB,CAAC,CACpC;aACA,QAAQ,CAAC,sCAAsC,CAAC;QACnD,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,yGAAyG,CAC1G;KACJ,CAAC;IAEF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,mBAAmB;YAC3B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,8DAA8D;YACpE,QAAQ,EACN,oFAAoF;SACvF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7D,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBACtE,MAAM,GAAG,CAAC,IAAI,CACZ,mBAAmB,EACnB,YAAY,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CACzD,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEhD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAExF,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,KAAK,CAAC;YAChB,CAAC,CAAC,4HAA4H;YAC9H,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,qBAAqB,MAAM,EAAE;YACvC,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,KAAK;YACL,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa;YACtB,sBAAsB,MAAM,CAAC,OAAO,EAAE;YACtC,YAAY,MAAM,CAAC,QAAQ,EAAE;YAC7B,oBAAoB,MAAM,CAAC,SAAS,EAAE;SACvC,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,eAAe;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,CAAC,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;oBACvC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC;gBAClD,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"get-works.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-works.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/resolve-researcher.tool.d.ts

@@ -5,7 +5,6 @@
  * @module mcp-server/tools/definitions/resolve-researcher.tool
  */
 import { z } from '@cyanheads/mcp-ts-core';
-import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
 export declare const orcidResolveResearcher: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
     name: z.ZodString;
     affiliation: z.ZodOptional<z.ZodString>;
@@ -33,14 +32,10 @@ export declare const orcidResolveResearcher: import("@cyanheads/mcp-ts-core").To
             pmid: "pmid";
         }>;
     }, z.core.$strip>>;
-    queryUsed: z.ZodString;
-    relaxedQuery: z.ZodOptional<z.ZodString>;
-    totalFound: z.ZodNumber;
-    notice: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, readonly [{
-    readonly reason: "no_candidates";
-    readonly code: JsonRpcErrorCode.NotFound;
-    readonly when: "No ORCID records matched even the relaxed query for this name.";
-    readonly recovery: "Try a different name spelling, use orcid_search_researchers with broader parameters, or verify the DOI/PMID is correct.";
-}]>;
+}, z.core.$strip>, undefined, {
+    readonly queryUsed: z.ZodString;
+    readonly relaxedQuery: z.ZodOptional<z.ZodString>;
+    readonly totalFound: z.ZodNumber;
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
 //# sourceMappingURL=resolve-researcher.tool.d.ts.map

package/dist/mcp-server/tools/definitions/resolve-researcher.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-researcher.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/resolve-researcher.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA0DjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6OjC,CAAC"}
+{"version":3,"file":"resolve-researcher.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/resolve-researcher.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AA0DjD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkOjC,CAAC"}